pi

pi-plugin-cc — drive the Pi coding agent from Claude Code 🥧

English · 中文

External references: Pi coding agent · Pi RPC mode · Pi providers

A Claude Code plugin that delegates reviews and coding tasks to the Pi coding agent. 1:1 fork of codex-plugin-cc, runtime swapped from Codex to Pi.

The hard dependency is pi, not any particular LLM. Pi can be configured for DeepSeek, OpenAI, Anthropic, Google, Ollama, LM Studio, or any OpenAI-compatible endpoint via ~/.pi/agent/models.json. The plugin defers all model selection to pi unless you override per command.

• Code review against the working tree or a branch base, with structured findings
• Adversarial review that challenges the design — not just spell-checks the diff
• Task delegation for diagnoses, refactors, and longer rescues, foreground or background
• Background job control — status, result, cancel, and stop-time review gate
• No OAuth — pi authenticates by API key (provider-specific), no codex login required

Plays well with pi-subagents: if installed, it works inside /pi:rescue runs without configuration.

🔄 How it works

Claude Code  ─►  /pi:review · /pi:rescue · /pi:status ...
                    │
                    ▼
            pi-companion.mjs (Node)
                    │  one pi --mode rpc subprocess per task
                    ▼
              Pi coding agent ─► whichever provider/model pi is configured for
                    │
                    ▼
               JSONL events + final assistant message
                    │
                    ▼
        job state files (status / result / cancel)

Codex's broker layer is gone — Pi is one-conversation-per-process, so the plugin spawns a fresh pi --mode rpc for each task. Background jobs are tracked in workspace-scoped state files. Review prompts inline the JSON schema since Pi has no outputSchema knob.

Slash commands

Command	What it does
/pi:setup	Verifies pi is installed + a provider is configured; toggles the stop-time review gate
/pi:review	Standard code review of local git state
/pi:adversarial-review	Steerable challenge review — questions the approach itself
/pi:rescue	Delegate investigation or implementation to a Pi run via the pi:pi-rescue subagent
/pi:status [job-id]	List active / recent Pi jobs in this repository
/pi:result <job-id>	Show the stored final output for a finished job
/pi:cancel <job-id>	Terminate a running background job

Every command accepts --model <id> to pin a specific model just for that run. With no --model and no env override (see Pick your model), pi falls back to whatever it has configured by default.

Quick Start

# 1. Install pi (required)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# 2. Configure a provider — pick one
export OPENAI_API_KEY=sk-...           # OpenAI
export ANTHROPIC_API_KEY=sk-ant-...    # Anthropic
export GOOGLE_API_KEY=...              # Google
export DEEPSEEK_API_KEY=sk-...         # DeepSeek
# or run a local model: see https://github.com/earendil-works/pi (Ollama / LM Studio)

# 3. Verify pi sees a model
pi --list-models | head

Install the plugin in Claude Code:

> /plugin marketplace add Agents365-ai/pi-plugin-cc
> /plugin install pi@agents365-pi
> /reload-plugins
> /pi:setup