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)

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:

{
  "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:

{
  "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:

cd ~/pi-extensions/agent-guidance && ./setup.sh

See each extension's README for details.