Tool Manager

Pi 扩展，提供 /tools 交互式工具浏览器 + 按需禁用/启用工具的能力。

功能

/tools 命令

打开 TUI 列表，浏览所有已注册的工具：

Tools (22 active)

[x]  agent_bg  [bg-tasks]       ← 灰色，被禁用
[ ]  bash      [builtin]        ← 绿色，活跃
[ ]  read      [builtin]        ← 绿色，活跃
[ ]  LoopCreate [pi-loop]       ← 绿色，来自 pi-loop

read  [builtin]  ● active       ← 详情面板（完整描述）
Read the contents of a file.
...

↑↓ navigate  •  space toggle(persist)  •  d toggle(temp)  •  enter detail  •  esc close

操作

| 按键 | 行为 | 持久化 | |------|------|--------| | ↑ ↓ | 浏览工具列表 | — | | Space | 切换禁用/启用 | ✅ 写入 session，跨重启生效 | | d | 临时切换禁用/启用 | ❌ 仅本次会话有效 | | Enter | 进入详情模式 | — | | Esc | 返回列表 / 关闭 | — |

在详情模式下： | 按键 | 行为 | |------|------| | ↑ ↓ | 滚动完整描述 | | Esc Enter | 返回列表模式 |

跨会话持久化

禁用的工具列表通过 pi.appendEntry() 存在 session 文件里，重启 pi、/reload、/new 等操作后自动恢复。

首次运行默认

首次安装时默认禁用 agent_bg（避免与 subagent 扩展冲突），其他工具均保持原始状态。

文件

• tool-manager/tool-manager.ts — 扩展主文件
• tool-manager/README.md — 英文文档
• tool-manager/README.zh.md — 中文文档

安装

将 tool-manager 文件夹放入 ~/.pi/agent/extensions/（自动发现），然后 /reload。