Skip to main content

Plaine command-line tools, including a lightweight stdio MCP server.

Project description

plaine

Lightweight Python CLI for Plaine.

MCP

Run the local FastMCP stdio server with uvx:

uvx plaine mcp

The server uses the same environment variables as @plaine/mcp:

Env var Required Default
PLAINE_API_KEY yes -
PLAINE_API_BASE no https://plaine.chat
PLAINE_CONVERSATION_ID no auto-provisioned by label
PLAINE_CONVERSATION_LABEL no ${hostname}:${basename(cwd)}
PLAINE_ON_TIMEOUT no stop
PLAINE_AGENT_DEVICE_KEY_FILE no OS secure storage

Tools: message_user, poll_messages, wait_for_message, send_and_wait, and describe_message_capabilities.

This local stdio package is plaintext-only until local device-key support lands. It refuses client-side-e2ee-v1 conversations rather than returning empty plaintext.

On first use, the server generates or loads a local X25519 agent-runtime device key, stores the private half locally, and registers only plaine-agent-runtime-key-v1:<public> with Plaine.

Example Claude Code setup:

claude mcp add plaine uvx plaine mcp \
  --env PLAINE_API_KEY=plane_xxx \
  --env PLAINE_API_BASE=https://plaine.chat

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plaine-0.1.3.tar.gz (49.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

plaine-0.1.3-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file plaine-0.1.3.tar.gz.

File metadata

  • Download URL: plaine-0.1.3.tar.gz
  • Upload date:
  • Size: 49.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for plaine-0.1.3.tar.gz
Algorithm Hash digest
SHA256 36ee096ec881cf8392c64ce5b3b14f541f47721b8e48354a3b721db120ab5825
MD5 9c373d6e806516d4803d6e4073cda0c5
BLAKE2b-256 10e4755a340668dbff77ab861d3f133b884e3a9f967221981f882e94dce9a7d4

See more details on using hashes here.

File details

Details for the file plaine-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: plaine-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for plaine-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a2640a2777d990c5242dca06de38f0ac0f7eb7846ca94ec1a3317d0e397fa171
MD5 40421e0caf4737b673e02e5aa2dee4f6
BLAKE2b-256 f8bee714ef4ac46613207297672d3af3297b8760ce504d34510352155b34cd13

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page