███╗   ███╗                  ██████╗ ██╗
████╗ ████║ ██╗   ██╗        ██╔══██╗   
██╔████╔██║ ╚██╗ ██╔╝ ████╗  ██████╔╝██╗
██║╚██╔╝██║  ╚████╔╝ ╚═══╝   ██╔═══╝ ██║
██║ ╚═╝ ██║   ╚██╔╝          ██║     ██║
╚═╝     ╚═╝   ██╔╝           ╚═╝     ╚═╝
github.com/spences10/my-pi
Pi CLI distribution

Runs the Pi coding-agent stack from the terminal: TUI, print mode, JSON events, RPC mode, SDK wiring, and the bundled my-pi extension set.

Scoped MCP activation

Load stdio or HTTP MCP servers globally or per project, with activation rules for cwd, GitHub org, and GitHub repo.

LSP agent tools

Expose language-server diagnostics, hover, definitions, references, and document symbols directly to the agent for safer code edits.

Context reduction

Move oversized command output, reads, MCP responses, and LSP dumps into searchable local context. Current global stats: 91.7% reduction and 10.6 MiB saved from chat.

Secret and command guardrails

Redact tool output, remind agents to use nopeek for env files, and require confirmation before destructive commands.

Skills, recall, and team mode

Activate skills by cwd, GitHub org, or repo; recall previous sessions; and coordinate RPC teammates with tasks, mailboxes, status, and worktrees.

Session playback

Uses recall, LSP diagnostics, context receipts, and terminal tools in one flow.

~/repos/my-pi (↯ main ?1 ↟1)
↑115k ↓6k R691k $1.090 (sub) 13.3%/272k
MCP 5/5 connected
my-pi-terminal-layout
gpt-5.4 · high
prompt:terse +1
Composable by design

Start with the CLI. Keep the parts that fit your workflow.

Run the prewired my-pi command, install individual extensions into Pi, or bind tools and skills to specific repos and orgs.

01
Run my-pi

Use the CLI when you want Pi with MCP, LSP, context reduction, recall, skills, redaction, telemetry, and team mode already wired together.

pnpx my-pi@latest
02
Add one extension

Already have a Pi setup? Install the same feature packages one at a time: LSP, MCP, context, skills, recall, team mode, and more.

pi install npm:@spences10/pi-lsp
03
Scope by workspace

Load MCP servers from mcp.json and activate skill profiles only for matching directories, GitHub orgs, or GitHub repos.

mcp.json + skill profiles
Package modules
The same features are available as reusable Pi packages.
View all packages
@spences10/pi-context@spences10/pi-lsp@spences10/pi-mcp@spences10/pi-redact@spences10/pi-recall@spences10/pi-skills@spences10/pi-team-mode@spences10/pi-telemetry
Safety built in

Keep secrets, destructive commands, and large output under control.

Context reduction

Oversized output moves into searchable local context instead of bloating the active prompt.

Secret-aware workflows

Redaction and nopeek reminders steer agents away from exposing .env values and service tokens.

Destructive-action friction

Confirmations add an explicit stop before risky shell commands or file operations.

FAQ

What the included extensions actually do.

my-pi is a Pi coding-agent distribution for terminal-first development. It wires MCP tools, LSP diagnostics, project skills, recall, context reduction, redaction, telemetry, and team mode into one install.