Pi Coding Agent
Cursor-like chat sidebar for your local Pi coding agent.
The extension spawns your installed pi CLI in --mode rpc mode, shares ~/.pi/agent (auth, models, packages, sessions), and renders streaming chat, tool cards, model/thinking controls, slash commands, extension statuses, and session history in a VS Code / Cursor webview.
Requirements
- VS Code or Cursor
1.90+
- Local Pi:
npm i -g @earendil-works/pi-coding-agent or bun i -g @earendil-works/pi-coding-agent
- At least one provider configured in
~/.pi/agent (same as the Pi CLI)
Develop
npm install
npm run typecheck
npm test
npm run build
Press F5 (“Run Pi Coding Agent Extension”) to launch an Extension Development Host, then open the Pi activity-bar icon.
Settings
| Setting |
Description |
piChat.piPath |
Path to pi (empty = auto: PATH, then ~/.bun/bin/pi) |
piChat.extraArgs |
Extra CLI args after --mode rpc |
piChat.streamingBehavior |
steer or followUp when sending mid-stream |
piChat.injectEditorContext |
Prepend active file/selection to prompts |
piChat.toolOutputCapKb |
Cap tool output forwarded to the UI (default 64) |
Commands
- Pi Coding Agent: Open
- Pi Coding Agent: New Session
- Pi Coding Agent: Abort
- Pi Coding Agent: Select Workspace Folder (multi-root workspaces)
The chat header also supports naming, forking, cloning, and exporting the current Pi session. History supports Pi's direct .jsonl session layout and legacy nested session directories.
