$ cat ~/map/pi-extensions-tmustier.md
pi-extensions (tmustier)
A curated grab-bag of extensions for the pi coding agent — file browser, parallel-session tab status, usage dashboard, long-running ralph loop, and arcade minigames.
extensions✓ Oct 16
Facts
- repository
- github.com/tmustier/pi-extensions ↗
- GitHub Stars
- ★ 495
- Forks
- 51
- license
- MIT
- npm / mo
- —
- last push
- Sep 22, 2026
install
pi install git:github.com/tmustier/pi-extensions## TL;DR
A personal pi extension collection focused on terminal ergonomics: an in-terminal file browser (/readfiles), parallel-session tab indicators, a flat long-task loop, per-model guidance files, a usage dashboard, and even arcade minigames.
## Key points
- $/readfiles is an in-terminal file browser and viewer widget — navigate files, view diffs, select code, and send comments to the agent without leaving pi or interrupting the run.
- $tab-status manages many parallel sessions with terminal tab indicators for done, stuck, and timed-out states.
- $pi-ralph-wiggum runs arbitrarily long tasks without diluting model attention — a flat version of the ralph-loop pattern, without subagents.
- $agent-guidance switches between model-specific guidance files (CLAUDE.md, CODEX.md, GEMINI.md) as you change models; /paste inserts editable text instead of paste summaries; /code picks code blocks from assistant messages to copy, insert, or run.
- $/usage shows cost, tokens, and messages by provider and model across today, this week, last week, and all time — with a compact mode for narrow terminals; session-recap catches you up when you return to a session; arcade ships sPIce-invaders, picman, ping, tetris, and mario-not for while tests run.
## FAQ
Q Can I enable only a subset of the extensions?
Yes. After pi install, edit the package entry in ~/.pi/agent/settings.json to a filtered one — set packages[0].extensions to the entry files you want, e.g. ["files-widget/index.ts"].
Q How do I run them from a local clone?
Add the individual paths to the extensions array in ~/.pi/agent/settings.json (the README lists the exact lines); agent-guidance additionally runs ./setup.sh once.
## References
## Related entries
$ big-pi
Model-driven compression that summarizes completed phases into tiered blocks while Pi's JSONL transcript stays authoritative and untouched.
$ Pi Taste
Local preference-learning extension that distills accepted and rejected turns into one readable taste.md.
$ pi-agent-substrate
Suspendable remote workspaces for pi and Oh My Pi, on a self-hosted Agent Substrate cluster.
## Guides
Last updated: Aug 31, 2026