p31 chat is a local-first, post-quantum, spoon-aware AI terminal interface. It routes through your own proxy, connects to MCP servers (PHOS Forge, Google Workspace), and adapts to your cognitive load.
- Spoon-aware AI — adapts interface and token usage based on your current spoon level
- K₄ family mesh — complete graph topology for family connection
- Post-quantum identity — ML-DSA-65 signatures, Ed25519 passports, SHA-512 telemetry
- MCP native — 26+ tools from PHOS Forge, Google Workspace integration
- Offline-first — no cloud dependency; runs via your own router proxy
- Beautiful TUI — Bubble Tea, command palette (Ctrl+P), fuzzy search, status bar
curl -fsSL https://p31-cli.pages.dev/install | bashOr via npm:
npm install -g @p31/clip31 chat # Start the interactive TUI
p31 spoon # Show current spoon level
p31 mesh status # View K₄ family mesh
p31 doctor # Run system diagnostics
p31 help # List all commands- Go 1.25.5+
- Node.js 18+ (for MCP servers)
- A running p31-router proxy on port 4001
| Server | Tools |
|---|---|
| PHOS Forge | 26 tools: file adoption, deploy, logbook, brain-dump, jitterbug, cognitive-state, self-healer, etc. |
| Google Workspace | Calendar, Gmail, Drive, Docs, Sheets, Contacts |
Edit ~/.p31/config.yaml:
proxy_url: http://localhost:4001/v1
proxy_model: flashgit clone https://github.com/p31labs/p31-cli
cd p31-cli
go mod download
go build -o p31 .
./p31 helpMIT — see LICENSE.