About P31 Governed Agent CLI
P31 Governed Agent CLI is a sovereign agent CLI for neurodivergent families, with interactive and autonomous modes. It includes a themed TUI, multiple LLM providers, and 133 MCP tools across 10 categories.
Key features
- 01Interactive TUI and chat modes
- 02Autonomous agent mode
- 03133 MCP tools in 10 categories
- 04Three LLM provider options
- 05Themed, adaptive interface
- 06SQLite session storage
Use cases
- 01Run an agent from an interactive terminal
- 02Use MCP tools for cognitive support
- 03Select a theme for the terminal interface
- 04Store agent sessions in SQLite
MCP support
It can run as an MCP server over stdio or HTTP, exposing 133 tools across 10 categories, including cognitive support, session state, and design resources.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.p31ca.org/mcpclaude mcp add --transport http org-p31ca-governed-agent-cli https://mcp.p31ca.org/mcp{"mcpServers":{"org-p31ca-governed-agent-cli":{"type":"http","url":"https://mcp.p31ca.org/mcp"}}}Open in Cursor{"servers":{"org-p31ca-governed-agent-cli":{"type":"http","url":"https://mcp.p31ca.org/mcp"}}}Open in VS Code{"mcpServers":{"org-p31ca-governed-agent-cli":{"type":"http","url":"https://mcp.p31ca.org/mcp"}}}{"mcpServers":{"org-p31ca-governed-agent-cli":{"serverUrl":"https://mcp.p31ca.org/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEP31 Sovereign CLI
Sovereign AI agent for neurodivergent families. OpenCode face, P31 guts.
Install
curl -fsSL https://cli.p31ca.org/install | bash
Or from source:
git clone https://github.com/p31labs/p31-cli.git
cd p31-cli
npm install
npm run build
npm link
Quick Start
p31 # Interactive TUI
p31 chat # One-shot chat
p31 agent # Autonomous agent mode
p31 mcp # MCP stdio server (133 tools)
p31 mcp:http # MCP HTTP server
p31 tui # Ink TUI with themes
p31 phos # PHOS forge commands
p31 spoons # Spoon level management
p31 session # Session management
p31 sync # Cross-app sync
Architecture
- TypeScript (ESM, Node.js >= 22)
- MCP Protocol — 133 tools across 10 categories
- OpenCode Plugins — 6 sovereign plugins
- 3 LLM Providers — Anthropic, Google Gemini, OpenRouter
- SQLite Sessions — Per-session-tree sharding
- Ink TUI — 3 themes, spoon-aware adaptive UI
- React Web UI — xterm.js terminal viewer
MCP Servers
| Category | Tools | Description |
|---|---|---|
| oasis | 11 | CLI session state |
| love | 4 | LOVE ledger |
| cognitive | 47 | Neurodivergent support |
| spaceship | 4 | DUNA / dome |
| ground-truth | 14 | Verified facts |
| marge | 12 | Design compliance |
| soulsafe | 15 | 3-gate verification |
| bob | 10 | Building ontology |
| component | 5 | Component registry |
| design | 11 | Design tokens |
| Total | 133 |
Configuration
// opencode.json
{
"mcp": {
"phos-forge": { "type": "local", "command": ["node", "/path/to/mcp-server.mjs"] },
"p31-crypto": { "type": "remote", "url": "https://p31-crypto-mcp.trimtab-signal.workers.dev/mcp" }
},
"plugin": ["spoon-monitor", "sovereign-id", "care-attest", "pqc-tools", "mesh-visualize", "honest-label"]
}
Design System
- Tokens:
tokens/tokens.yml - Components:
tokens/components.yml - Themes: p31ca, phosphorus31, crisis
- Accessibility: Atkinson Hyperlegible, 48px touch targets, WCAG AAA
Environment Variables
| Variable | Description |
|---|---|
LOVE_LEDGER_URL | LOVE ledger endpoint |
LEDGER_BRIDGE_URL | Ledger bridge endpoint |
P31_USER_ID | Default user ID |
OPENCODE_CONFIG | Custom OpenCode config path |
License
MIT — P31 Labs, Inc.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.