References
Design essays, official Pi documentation, extension examples, and where piex features come from.
Start here
Pi’s design manifesto and Extension docs, oh-my-pi as the main feature source, and per-package provenance.
Design philosophy
| Resource | Notes |
|---|---|
| What I learned building an opinionated and minimal coding agent | Pi author’s design manifesto: minimal prompt/toolset, No plan mode, No sub-agents, etc. |
| pi README — Philosophy | “aggressively extensible”; official “What pi doesn't do” list |
| oh-my-pi README | Self-description of the fork + batteries-included path; piex’s main feature source |
| porting-from-pi-mono.md | omp’s upstream backport playbook—first-hand cost of forking |
Official Pi docs
From packages/coding-agent in earendil-works/pi.
Links assume branch
main; if 404, adjust against the current default branch.
| Doc | Link |
|---|---|
| Pi main docs | README.md |
| Extension development | docs/extensions.md |
| Package management | docs/packages.md |
| Prompt templates | docs/prompt-templates.md |
| Skills | docs/skills.md |
| Themes | docs/themes.md |
| TUI components | docs/tui.md |
| Keybindings | docs/keybindings.md |
| SDK | docs/sdk.md |
| Custom providers | docs/custom-provider.md |
| Models | docs/models.md |
Extension examples
Key examples:
| Example | Use |
|---|---|
| tool-override.ts | Override built-in tools (hashline reference) |
| tools.ts | Custom tools + enable/disable |
| plan-mode/index.ts | Plan mode (base for plan) |
| subagent/ | Sub-agent reference |
| summarize.ts | Custom compaction |
| permission-gate.ts | Permission control |
| protected-paths.ts | Path protection |
Feature provenance
| Feature | Source project | Source tree |
|---|---|---|
| hashline | oh-my-pi | packages/hashline/src/ |
| DAP | oh-my-pi | packages/coding-agent/src/dap/ |
| LSP | oh-my-pi | packages/coding-agent/src/lsp/ |
| LSP post-edit diagnostics | OpenCode | packages/opencode/src/lsp/ + edit/write touchFile |
| Plan mode | oh-my-pi | packages/coding-agent/src/plan-mode/ |
| Review command | oh-my-pi | bundled/review/ |
| Review tool | oh-my-pi | tools/review.ts |
| Plan TOC | oh-my-pi | plan-toc.ts |
| dark-terminal theme | opencode-themes | dark-terminal.json |
Other projects
- oh-my-pi: primary feature source
- Claude Code: interaction-pattern reference
- OpenCode: extension-mechanism reference
- opencode-themes: dark terminal palette source
Source Markdown: docs/references.md