pi-extensions

Personal extensions for the Pi coding agent.

Extensions

| Extension | Description |
|-----------|-------------|
| /readfiles | In-terminal file browser and viewer widget. Navigate files, view diffs, select code, send comments to agent - without leaving Pi, and without interrupting your agent |
| tab-status | Manage as many parallel sessions as your mind can handle. Terminal tab indicators for
✅ done / 🚧 stuck / 🛑 timed out |
| ralph-wiggum | Run arbitrarily-long tasks without diluting model attention. Flat version without subagents like ralph-loop |
| agent-guidance | Switch between Claude/Codex/Gemini with model-specific guidance (CLAUDE.md, CODEX.md, GEMINI.md) |
| /usage | 📊 Usage statistics dashboard. See cost, tokens, and messages by provider/model across Today, This Week, All Time |
| /paste | Paste editable text, not [paste #1 +21 lines]. Running /paste with optional keybinding |
| /code | Pick code blocks or inline snippets from assistant messages to copy, insert, or run with /code |
| arcade | Play minigames while your tests run: 👾 sPIce-invaders, 👻 picman, 🏓 ping, 🧩 tetris, 🍄 mario-not |

Skills

| Skill | Description |
|-------|-------------|
| extending-pi | Guide for extending Pi — decide between skills, extensions, prompt templates, themes, or packages. |
| ↳ skill-creator | Detailed guidance for creating Pi skills. |
| ralph-wiggum | Skill instructions for long-running development loops. |

Install (pi package manager)

``bash
pi install git:github.com/tmustier/pi-extensions
`

To enable only a subset, replace the package entry in ~/.pi/agent/settings.json with a filtered one:

`json
{
"packages": [
{
"source": "git:github.com/tmustier/pi-extensions",
"extensions": ["files-widget/index.ts"]
}
]
}
`

Quick Setup

If you keep a local clone, add extensions to your ~/.pi/agent/settings.json:

`json
{
"extensions": [
"~/pi-extensions/files-widget",
"~/pi-extensions/tab-status/tab-status.ts",
"~/pi-extensions/arcade/spice-invaders.ts",
"~/pi-extensions/arcade/ping.ts",
"~/pi-extensions/arcade/picman.ts",
"~/pi-extensions/arcade/tetris.ts",
"~/pi-extensions/arcade/mario-not/mario-not.ts",
"~/pi-extensions/ralph-wiggum",
"~/pi-extensions/agent-guidance/agent-guidance.ts",
"~/pi-extensions/raw-paste",
"~/pi-extensions/code-actions",
"~/pi-extensions/usage-extension"
]
}
`

For agent-guidance, also run the setup script:
`bash
cd ~/pi-extensions/agent-guidance && ./setup.sh
``

See each extension's README for details.