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。