pi-extensions

Example extensions for the [Pi coding agent](https://github.com/badlogic/pi-mono). These are the first Pi extensions I ever created and are meant to inspire you on some things you can do with Pi. I still use some of these, but note that if you want the ma

Packages

Package details

extensionskill

Install pi-extensions from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-extensions
Package
pi-extensions
Version
0.1.77
Published
Nov 3, 2026
Downloads
2,767/mo · 1,741/wk
Author
tmustier
License
MIT
Types
extension, skill
Size
8.9 MB
Dependencies
0 dependencies · 5 peers
Pi manifest JSON
{
  "skills": [
    "./extending-pi/SKILL.md",
    "./pi-ralph-wiggum/SKILL.md"
  ],
  "extensions": [
    "./agent-guidance/agent-guidance.ts",
    "./arcade/spice-invaders.ts",
    "./arcade/picman.ts",
    "./arcade/ping.ts",
    "./arcade/tetris.ts",
    "./arcade/mario-not/mario-not.ts",
    "./code-actions/index.ts",
    "./files-widget/index.ts",
    "./raw-paste/index.ts",
    "./pi-ralph-wiggum/index.ts",
    "./session-recap/index.ts",
    "./tab-status/tab-status.ts",
    "./usage-extension/index.ts"
  ],
  "changelogPath": "./UPDATE_NOTES.md"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extensions

Example extensions for the Pi coding agent. These are the first Pi extensions I ever created and are meant to inspire you on some things you can do with Pi. I still use some of these, but note that if you want the maintainer's (my) pi setup, most of it is currently here https://github.com/tmustier/vibes.

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
pi-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, Last Week, This Month, Last 30 Days, and All Time — with a compact view for narrow terminals
/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
session-recap While-you-were-away recap above the editor when you return to a session. Keeps you in flow while multi-clauding
arcade Play minigames while your tests run: 👾 sPIce-invaders, 👻 picman, 🏓 ping, 🧩 tetris, 🍄 mario-not

Agent Skills

Agent Skill Description
extending-pi Guide for extending Pi — decide between Agent Skills, extensions, prompt templates, themes, models/providers, or packages.
pi-ralph-wiggum Agent 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"]
    }
  ]
}

Update notices

Pi 1.5 and later show short startup notices from the installed package's UPDATE_NOTES.md. The first launch is silent; collapseChangelog reduces notices to one line per package. The full history stays in CHANGELOG.md.

The root bundle and Arcade announce only changes affecting all their extensions, because Pi cannot filter notes by which extensions you load. Standalone packages have their own notes, which do not appear through the root bundle or Vibes.

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/pi-ralph-wiggum",
    "~/pi-extensions/agent-guidance/agent-guidance.ts",
    "~/pi-extensions/raw-paste",
    "~/pi-extensions/code-actions",
    "~/pi-extensions/session-recap",
    "~/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.