tmustier/pi-extensions

A set of delightful extensions for Pi

TypeScript

485

358 commits

updated Sep 22, 2026

See the code

README

pi-extensions

Personal extensions for the Pi coding agent.

Extensions

ExtensionDescription
/readfilesIn-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-statusManage as many parallel sessions as your mind can handle. Terminal tab indicators for
✅ done / 🚧 stuck / 🛑 timed out
pi-ralph-wiggumRun arbitrarily-long tasks without diluting model attention. Flat version without subagents like ralph-loop
agent-guidanceSwitch 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, and All Time — with a compact view for narrow terminals
/pastePaste editable text, not [paste #1 +21 lines]. Running /paste with optional keybinding
/codePick code blocks or inline snippets from assistant messages to copy, insert, or run with /code
session-recapWhile-you-were-away recap above the editor when you return to a session. Keeps you in flow while multi-clauding
arcadePlay minigames while your tests run: 👾 sPIce-invaders, 👻 picman, 🏓 ping, 🧩 tetris, 🍄 mario-not

Agent Skills

Agent SkillDescription
extending-piGuide for extending Pi — decide between Agent Skills, extensions, prompt templates, themes, models/providers, or packages.
skill-creatorDetailed guidance for creating Agent Skills.
pi-ralph-wiggumAgent 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/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.

extension
npm
pi
pi-coding-agent

Contributors

tmustier

348 commits

nicobailon

2 commits

hheli

1 commits

israrwz

1 commits

tmustier/pi-extensions

A set of delightful extensions for Pi

TypeScript

485

358 commits

updated Sep 22, 2026

See the code

README

pi-extensions

Personal extensions for the Pi coding agent.

Extensions

ExtensionDescription
/readfilesIn-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-statusManage as many parallel sessions as your mind can handle. Terminal tab indicators for
✅ done / 🚧 stuck / 🛑 timed out
pi-ralph-wiggumRun arbitrarily-long tasks without diluting model attention. Flat version without subagents like ralph-loop
agent-guidanceSwitch 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, and All Time — with a compact view for narrow terminals
/pastePaste editable text, not [paste #1 +21 lines]. Running /paste with optional keybinding
/codePick code blocks or inline snippets from assistant messages to copy, insert, or run with /code
session-recapWhile-you-were-away recap above the editor when you return to a session. Keeps you in flow while multi-clauding
arcadePlay minigames while your tests run: 👾 sPIce-invaders, 👻 picman, 🏓 ping, 🧩 tetris, 🍄 mario-not

Agent Skills

Agent SkillDescription
extending-piGuide for extending Pi — decide between Agent Skills, extensions, prompt templates, themes, models/providers, or packages.
skill-creatorDetailed guidance for creating Agent Skills.
pi-ralph-wiggumAgent 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/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.

extension
npm
pi
pi-coding-agent

Contributors

tmustier

348 commits

nicobailon

2 commits

hheli

1 commits

israrwz

1 commits

Languages

TypeScript

63.7%

JavaScript

33.2%

Python

1.5%

Rust

1.2%