Official References¶
Direct links to pi's official documentation, source code, and community resources.
Core Documentation¶
| Document | URL |
|---|---|
| README (main docs) | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md |
| Extensions guide | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/extensions.md |
| Skills guide | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md |
| Session format | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/session.md |
| Packages guide | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/packages.md |
| Themes guide | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/themes.md |
| Prompt templates | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/prompt-templates.md |
| Keybindings | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/keybindings.md |
| Custom providers | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/custom-provider.md |
| Adding models | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/models.md |
| RPC mode | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/rpc.md |
| SDK usage | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/sdk.md |
| TUI components | https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/tui.md |
Extension Examples (50+)¶
https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent/examples/extensions
Notable examples in the repo:
- summarize.ts -- Conversation summaries
- snake.ts -- Snake game (TUI demo)
- async-subagent/ -- Sub-agent implementation
- Various permission gate patterns
Source Code¶
| Package | Path |
|---|---|
| pi-ai (LLM API) | https://github.com/badlogic/pi-mono/tree/main/packages/ai |
| pi-agent-core | https://github.com/badlogic/pi-mono/tree/main/packages/agent |
| pi-coding-agent | https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent |
| pi-tui | https://github.com/badlogic/pi-mono/tree/main/packages/tui |
| pi-web-ui | https://github.com/badlogic/pi-mono/tree/main/packages/web-ui |
| pi-mom (Slack bot) | https://github.com/badlogic/pi-mono/tree/main/packages/mom |
| pi-pods (vLLM) | https://github.com/badlogic/pi-mono/tree/main/packages/pods |
Community Packages¶
| Package | npm | GitHub |
|---|---|---|
| shitty-extensions | npm:shitty-extensions |
https://github.com/hjanuschka/shitty-extensions |
| pi-model-switch | npm:pi-model-switch |
https://github.com/nicobailon/pi-model-switch |
| pi-subagent-enhanced | -- | https://github.com/nicobailon/pi-subagent-enhanced |
| @marckrenn/pi-sub-core | npm:@marckrenn/pi-sub-core |
https://github.com/marckrenn/pi-sub |
| pi-skills (official) | git:github.com/badlogic/pi-skills |
https://github.com/badlogic/pi-skills |
| pi-coding-agent (Emacs) | MELPA | https://github.com/dnouri/pi-coding-agent |
CLI Tools (Mario's agent-tools)¶
https://github.com/badlogic/agent-tools
CLI tools designed for agent use with READMEs the agent reads on demand.
Blog Posts and Articles¶
| Title | Author | URL |
|---|---|---|
| What I learned building an opinionated and minimal coding agent | Mario Zechner | https://mariozechner.at/posts/2025-11-30-pi-coding-agent/ |
| MCP vs CLI: Benchmarking Tools for Coding Agents | Mario Zechner | https://mariozechner.at/posts/2025-08-15-mcp-vs-cli/ |
| Pi: The Minimal Agent Within OpenClaw | Armin Ronacher | https://lucumr.pocoo.org/2026/1/31/pi/ |
| Why I Switched to Pi | Helmut Januschka | https://www.januschka.com/pi-coding-agent.html |
| The Only Coding Agent You'll Ever Need | Ewald Benes | https://ewaldbenes.com/en/blog/the-only-coding-agent-you-ll-ever-need |
| An Emacs mode for a shitty coding agent | Daniel Nouri | https://danielnouri.org/notes/2025/12/30/an-emacs-mode-for-a-shitty-coding-agent/ |
| Your MCP Doesn't Need 30 Tools: It Needs Code | Armin Ronacher | https://lucumr.pocoo.org/2025/8/18/code-mcps/ |
| Replace MCP With CLI | Cobus Greyling | https://cobusgreyling.substack.com/p/replace-mcp-with-cli-the-best-ai |
Community Discussions¶
| Thread | Platform |
|---|---|
| Change your coding agent to pi | https://www.reddit.com/r/ClaudeCode/comments/1qu5fa4/ |
| Why I switched from Claude Code to Pi | https://www.reddit.com/r/ClaudeCode/comments/1r11egp/ |
| HN discussion on Mario's blog post | https://news.ycombinator.com/item?id=46844822 |
| pi-coding-agent in Emacs | https://www.reddit.com/r/emacs/comments/1qa8xql/ |
DeepWiki (AI-generated docs from source)¶
https://deepwiki.com/badlogic/pi-mono/4-@mariozechnerpi-coding-agent