P31 Sovereign CLI

Sovereign AI agent for neurodivergent families. OpenCode face, P31 guts.

Installation

curl -fsSL https://cli.p31ca.org/install | bash

Or install from source:

git clone https://github.com/p31labs/p31-cli
cd p31-cli
npm install && npm run build && npm link

Quick Start

Interactive Chat

p31 chat --model deepseek-v4-flash

Autonomous Agent

p31 agent "Fix the evidence vault endpoint"

Spoon-Aware TUI

p31 tui

Phos-Forge Tools

p31 phos status              # Show manifest stats
p31 phos adopt               # Classify files
p31 phos state               # Cognitive state
p31 phos tide                # Temporal patterns
p31 phos jitterbug "problem" # Fractal research

MCP Tools

p31 mcp list                 # List MCP servers
p31 mcp serve --port 3000    # Start HTTP server

Spoon Controls

p31 spoons        # Show current level
p31 spoons 1      # Low energy mode
p31 spoons 5      # Full energy mode

Commands

| Command | Description | |---------|-------------| | chat | Interactive chat session | | agent | Run autonomous agent | | tui | Spoon-aware terminal UI | | mcp | MCP tool management | | models | List available LLM models | | session | Session management | | spoons | Set cognitive load level | | init | Initialize config | | phos | Phos-forge tools (adopt, status, state, tide, jitterbug, aura, etc.) |

Phos-Forge Subcommands

| Command | Description | |---------|-------------| | phos adopt [path] | Classify and move files | | phos status | Manifest stats and activity | | phos classify <path> | Classify a single file | | phos learn [dir] | Infer canonical map | | phos rollback [count] | Roll back file moves | | phos watch | Background file watcher | | phos deploy <target> | Deploy with spoon gating | | phos dashboard | Convergence dashboard | | phos state | Cognitive state (5-dim) | | phos estimate | Fresh cognitive estimate | | phos calibrate | Self-report spoon level | | phos remediate | Self-healer cycle | | phos healer-log | Healer activity log | | phos healer-diag | Healer diagnostics | | phos reflex [n] | Reflex arc status | | phos tide | Temporal patterns | | phos kappa | Outcome-aware weights | | phos logbook | Session memory state | | phos cartographer <query> | Semantic code search | | phos trace <symbol> | Symbol references | | phos related <path> | Related files | | phos brain-dump <text> | Brain dump pipeline | | phos brain-sessions [n] | Recent brain sessions | | phos jitterbug <problem> | Fractal research workflow | | phos aura | Cognitive visualization | | phos bus-emit <type> <payload> | Emit event |

TUI Slash Commands

In the TUI chat view (p31 tui), type these slash commands:

| Command | Description | |---------|-------------| | /help | Show available slash commands | | /phos status | Phos-forge status | | /phos state | Cognitive state | | /phos tide | Tide temporal patterns | | /phos kappa | Kappa weights | | /phos logbook | Logbook status | | /phos reflex | Reflex arc status |

Architecture

• TypeScript + Node.js — Type-safe, production-ready
• OpenCode Plugin System — 6 P31 sovereign plugins (DID, PQC, care, mesh, spoon, honest-label)
• MCP Protocol — 9 servers, 280+ tools (phos-forge, crypto, justice, care, mesh, billing, federation, ledger)
• SQLite Sessions — Per-session-tree sharding with WAL mode
• 3 LLM Providers — Anthropic, Google Gemini, OpenRouter (auto-detected)
• Ink TUI — Spoon-aware terminal UI with 3 themes (cyan cockpit, warm garden, crisis minimal)
• Spoon-Aware — Cognitive load levels 1/3/5 with adaptive UI

License

MIT — P31 Labs, Inc.