Pi Code

pi-code

\

\

Claude Code experience for the pi coding agent, in one package. Point pi at a project that already has a .claude/ directory and it reads your existing config: rules, commands, skills, hooks, output styles, MCP servers, and agents. It also adds the Claude Code features pi lacks: a todo overlay, checkpoints, memory, web search, subagents, and goals.

What a repository ships is treated as untrusted until you approve it: project MCP servers, hooks, agents, rules, output styles, commands and skills load only once you say yes. A headless run (pi -p) cannot ask, so an undecided project loads none of them there, which is stricter than Claude, where a headless run uses them without showing the dialog.

Requirements

pi >=0.80.5 (0.99.x recommended) and Node >=22.19 for current pi. On an older pi, pi-code warns once at session start.

Install

Other sources:

One pi install and everything below loads on the next start. pi list shows what is installed, pi config toggles individual resources, and pi update pi-code upgrades it. Each feature is an extension under extensions/.

What it does

Each topic links to its own doc with the full contract and any divergences from Claude Code.

- Hooks — your .claude/settings.json hooks on every lifecycle event, with Claude's tool vocabulary, decision fields, and background hooks.
- MCP servers — every Claude config scope, all four transports, OAuth, managed policy, timeouts, prompts, and resources. On pi 0.99 and later the servers are handed to pi's own MCP support.
- Custom slash commands — .claude/commands with arguments, bash spans, @file inlining, frontmatter, and model invocation.
- Skills — .claude/skills discovery plus the same dynamic content commands get.
- Subagents — built-in and custom agents, background runs,…