A small toolkit for the Pi coding agent.
Install · Website · Documentation
SpecPi extends Pi with chat, review tools, and focused delegation. Its principles are simple: you choose the improvements, changes stay small and reversible, improvement records stay local, and checks matter more than an agent's claims.
Watch the showcase · 51 seconds
- Focused delegation. One agent makes changes. Up to two read-only subagents help investigate and review. Research and design
- Background tasks. Start an approved dev server, test suite, or watch build, inspect bounded output, and stop it without blocking other work.
- Review as you work. Track changed files, inspect diffs, check pages in a browser, and review risky commands.
- Improvements you choose. Record recurring problems, select one with
/harness-improvement, and test the change before calling it done.
Problem collection is off by default. Its records stay on your machine. Pi connects to your chosen model provider.
Requires Node.js 22.19+, npm, and Git. SpecPi needs Pi 0.84.4+; the installer can add it if missing.
npm install --global specpi@latest
specpi plan
specpi install
specpi doctorPreview the changes, confirm the install, then check the setup. Restart Pi when finished.
To pin this release, use npm install --global specpi@0.19.1.
Delegation is enabled at startup. Use /delegate off to turn it off.
Setup, updates & removal · Delegation settings
Chat beside your code, attach files, and switch conversations.
Install from Marketplace · Requires VS Code 1.96+, Node.js 22.19+, and Pi 0.84.4+. SpecPi is optional.
In VS Code, find SpecPi Chat by tannermidd in Extensions and install it. Open SpecPi in the Activity Bar, then Connect Pi.
Chat 0.4.1 shows a compact delegation strip only while workers run or settle, and opens workspace image links in the image viewer. SpecPi 0.19.1 fixes delegation when switching GitHub Copilot models in the same chat, including Luna → Opus → Luna. Update the harness and use Restart Pi to load the fix; this patch does not require a Chat update. Later model switches do not require a restart. New Chat sessions start with Guard off; use /guard guard or /guard strict to enable it.
Commands · Chat help · Development · Security · Release notes