Metadata-Version: 2.4
Name: plaine
Version: 0.1.0
Summary: Plaine command-line tools, including a lightweight stdio MCP server.
Project-URL: Homepage, https://plaine.chat
Project-URL: Repository, https://github.com/dsf-plaine/plane-messaging
Project-URL: Documentation, https://plaine.chat/docs/integrations/claude-code
Author: Plaine
Keywords: claude-code,codex,mcp,plaine
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# plaine

Lightweight Python CLI for [Plaine](https://plaine.chat).

## MCP

Run the local stdio MCP server with `uvx`:

```bash
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` |

Example Claude Code setup:

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

