$ cat ~/map/pi-extensions-tmustier.md

pi-extensions (tmustier)

Pi 编程 agent 的扩展合集，覆盖文件浏览、并行会话状态、用法仪表盘、长任务循环，以及 TUI 街机小游戏。

extensions✓ 10月16日

事实速查

安装

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

## 速览

一套以终端人体工学见长的个人 pi 扩展集：终端内文件浏览器（/readfiles）、并行会话标签指示、扁平长任务循环、按模型切换的指引文件、用量面板，甚至还有街机小游戏。

$/readfiles 是终端内的文件浏览与查看组件——浏览文件、看 diff、选代码、给 agent 发评论，全程不离开 pi、不打断正在运行的 agent。
$tab-status 用终端标签指示器管理多个并行会话：完成、卡住、超时三种状态一目了然。
$pi-ralph-wiggum 不经子代理、以扁平方式运行超长任务，避免稀释模型注意力——是 ralph-loop 模式的扁平版。
$agent-guidance 随模型切换对应的指引文件（CLAUDE.md、CODEX.md、GEMINI.md）；/paste 插入可编辑文本而非粘贴摘要；/code 从助手消息里挑代码块复制、插入或运行。
$/usage 按 provider 与模型展示今日、本周、上周、全部时间的成本、token 与消息数，窄终端有紧凑视图；session-recap 在你回到会话时补齐离线期间发生的事；arcade 内置 sPIce-invaders、picman、ping、tetris、mario-not，跑测试时来一局。

Q 能只启用其中一部分扩展吗？

能。pi install 后编辑 ~/.pi/agent/settings.json 里的 packages 条目做过滤——把 packages[0].extensions 设为想要的入口文件，例如 ["files-widget/index.ts"]。

Q 从本地克隆怎么运行？

把各扩展路径加入 ~/.pi/agent/settings.json 的 extensions 数组（README 列出了每一条）；agent-guidance 还需在其目录跑一次 ./setup.sh。