tool-map

让 mcode 一次就对你的电脑了如指掌，不用每次任务都重新教它工具在哪。

mcode (MiniMax Code) 跑得久了，工具链越攒越多：node、npm、git、gh、docker、pwsh、python、各种 MCP server，还有 openclaw / mcode / codex 这些 CLI——每次新会话它都得从头摸索一遍，第一次找不到的工具，第二次还是找不到，每次踩相同的坑。

tool-map 把这个过程提前做完，跑一次扫描，结果常驻到 Plugin 数据目录：

• tools.summary.md — 6 KB 的轻量索引，会话开头一打开就知道有什么
• tools.md — 完整清单，按类别分组，含路径 / 大小 / 修改时间
• tools.json — 给程序读的，方便过滤查询

之后 AI 不用再问"npm 在哪？git 在哪？"，自己查 summary 就有。装了新工具再扫一次就更新。零依赖，跨平台，Apache-2.0，纯 Node 内置模块。

安装

PR #5 还没合之前先用本地装：

git clone https://github.com/antianqi/tool-map.git
mcode plugin add ./tool-map

合了之后直接：

mcode plugin add antianqi/tool-map@official

怎么用

装完插件，agent 会自动在合适场景下用：用户问"装了什么"、"工具在哪"、"怎么跑 X"时，先读 summary，需要详情再看 tools.md。

需要刷新时让 agent 跑：

node "${PLUGIN_ROOT}/scripts/scan.mjs"

或者直接说"刷新一下工具清单"。

几个例子

我电脑上装了哪些 MCP server？git 在哪？

刚刚装了 pnpm，帮我刷新一下工具清单。

用 gh 命令看下我最近 5 个 PR。

跨平台

平台	状态
Windows 10/11 (PowerShell 5.1+ / pwsh 7)	主要支持
macOS 12+	支持
Linux x86_64 / arm64	支持

不写死任何路径，所有根目录都从 $HOME / $ProgramFiles / $APPDATA / $PATH / $TOOL_MAP_ROOTS 推导。Mac 用户、Linux 用户、装在 D 盘的用户都能直接用。

自己开发

node scripts/smoke.mjs       # 静态扫自己的源码,确认没硬编码路径 / 字面 token
node --test test/            # 跑 6 个 node:test 用例

零 npm 依赖，没有 build 步骤。

怎么工作的

• 走已知根目录 + $PATH，跳过 50 MB 以上的大文件和无效扩展名
• 15 个常用 CLI 的版本探测（node / npm / pnpm / yarn / mcode / openclaw / clawhub / codex / git / python / python3 / gh / docker / pwsh / powershell），每个 5 秒超时
• 读 ~/.gitconfig 的 user/email（公开身份信息）
• 读 ~/.ssh/ 下文件名（不读内容，不读 passphrases）
• 三件套用 staging + rename 原子写，崩了不留半截

隐私

• 零网络请求，完全离线
• 不带任何凭据、token、OAuth client
• 不发任何遥测、analytics
• 没有任何第三方服务依赖
• 只读公开信息（git user、ssh key 文件名），不读任何私密内容

协议

Apache-2.0. 见 LICENSE。

链接

• 官方注册表 PR: MiniMax-AI/MiniMax-Code-Plugins#5
• 反馈: https://github.com/antianqi/tool-map/issues