tools-manager

v0.3.0

Published

a day ago

A Bun CLI for managing AI agent skills and MCP server configuration across tools.

0High
0Medium
0Low

pipihua

Tools Manager

English

Tools Manager (tm) 是一个基于 Bun 的 CLI，用来统一管理 Codex、Claude Code、Cursor 和 OpenCode 等 AI Agent 的 skills 与 MCP server 配置。

它提供一个本地统一管理入口：

Skills 存放在 ~/.tools-manager/skills
Skill presets 用来按 Agent 或工作流给 skills 分组
MCP servers 存储在 Tools Manager 数据库中，并可同步到各 Agent 的配置文件

不想记子命令时，直接运行无参数的 tm，打开交互式命令菜单：

下面这张图展示 skills 和 MCP servers 如何在本地 Agent 与 Tools Manager 存储之间流转：

Tools Manager workflow

环境要求

Bun >= 1.3.0
Git，用于从 Git URL 导入 skills，以及执行 tm backup

安装

全局安装：

npm install -g tools-manager

验证 CLI：

tm status

如果是源码检出方式使用，见开发。

快速开始

先把所有本地 Agent 里已有的 skills 导入 Tools Manager，再同步回所有支持的 Agent：

# 创建 Tools Manager 的本地管理目录和默认配置。
tm init

# 从 Codex、Claude Code、Cursor 和 OpenCode 导入已有 skills。
tm skills add --tool all

# 查看当前由 Tools Manager 托管的 skills。
tm skills list

# 把 Default preset 应用到所有支持的 Agent。
tm presets apply Default

如果还没有 link 或安装这个包，可以使用：

bun run tm init
bun run tm skills add --tool all
bun run tm skills list
bun run tm presets apply Default

默认情况下，Tools Manager 会把状态写入：

~/.tools-manager

设置 TOOLS_MANAGER_HOME 可以使用自定义管理目录。

运行无参数 tm 可以打开交互式命令菜单：

tm

菜单支持用方向键选择常用的 skill、skill preset、MCP、agent 和 backup 命令。菜单包含手动添加 skill source、手动添加 MCP server、从已有 Agent 导入的流程。涉及 tool 参数时会进入选项选择器，默认选择 all。命令执行后，按 Enter 或 Esc 返回菜单。

Web 管理台

启动本地管理页面并自动在浏览器中打开：

tm web

管理台复用 CLI 的核心能力，可以管理 skills、presets、MCP servers，执行 Agent 导入与同步，以及 Git 备份。Skills 和 MCP 的 All 视图支持单项同步、多选和全选同步；在特定 Agent 筛选下移除 skill 时，只会删除该 Agent 的受管 symlink。

点击 skill 名称可以查看 source 元数据并编辑完整 SKILL.md；点击 MCP server 名称可以修改名称、command、arguments、environment、目标 tools 和启用状态。MCP environment 值只通过本地详情接口读取，管理台 snapshot 仍不会暴露这些值。

服务只监听 127.0.0.1。默认使用 4343 端口，端口被占用时会自动尝试后续本地端口。也可以指定端口或禁止自动打开浏览器：

tm web --port 4400
tm web --no-open

使用管理台期间需保持终端进程运行，按 Ctrl+C 停止服务。

在源码仓库中调试时，启动监听模式：

bun run dev

首次打开 http://127.0.0.1:4343 即可。导入的源码文件发生变化后，Bun 会重启服务，已打开的管理页面会在新服务就绪后自动刷新。需要隔离测试数据时可以指定临时管理目录：

TOOLS_MANAGER_HOME=/tmp/tools-manager-dev bun run dev

Skills

添加本地 skill 目录：

tm skills add ./my-skill

从某一个本地 Agent 导入已有 skills：

tm skills add --tool codex
tm skills add --tool cursor
tm skills add --tool claude_code
tm skills add --tool opencode

从所有支持的本地 Agent 导入已有 skills：

tm skills add --tool all

从 Agent 导入时，Tools Manager 会把 skills 复制到 ~/.tools-manager/skills，然后用指向托管副本的 symlink 替换原本的本地 Agent skill 目录。

从 Git 导入 skill：

tm skills add '[email protected]:group/repo.git#main:path/to/skill'

如果 source 中包含多个 skill 目录，会导入所有发现的 skills。已有同名 skill 会被更新。

仓库目录结构要求见 Remote Skill Repositories。

列出托管的 skills：

tm skills list

列出当前本地 Agent 可见的 skills：

tm skills list --tool codex
tm skills list --tool all

查看某个托管 skill：

tm skills show my-skill

移除某个托管 skill：

tm skills remove my-skill

如果 Agent 的 skill 目录中存在指向托管 skill source 的 symlink，Tools Manager 会展示这些 symlink，并在删除托管 source 和 Agent symlink 前要求确认。非交互场景可使用 --yes：

tm skills remove my-skill --yes

只删除某个 Agent 的受管 symlink，同时保留 tm source、preset 关系和其他 Agent 链接：

tm skills unlink my-skill --tool codex

把一个或多个选定 skills 同步到 Agent skill 目录：

tm skills sync-selected my-skill --tool cursor
tm skills sync-selected skill-a skill-b --tool all --mode copy

需要一起维护和应用一组 skills 时，使用 preset：

tm presets apply Default
tm presets apply Work --tool codex --mode symlink

两个命令都默认使用 --tool all，并遵循配置中的 sync_mode。传入 --mode symlink 或 --mode copy 可以覆盖本次执行。tm skills sync [preset] 仍作为应用 preset 的兼容命令保留。

无参数 tm 交互菜单为选定 skill 同步提供 checkbox 式多选流程。

Skill Presets

Skill presets 是命名的 skill 分组，用来决定哪些 skills 要一起同步。

例如，日常使用的 skills 可以放在 Default，工作专用的 skills 可以放在 Work。导入的 skills 会自动加入 Default。

列出 skill presets：

tm presets list

把 preset 应用到 Agent：

tm presets apply Default
tm presets apply Work --tool cursor --mode copy

把单个 skill 从一个 preset 移动到另一个 preset：

tm presets move-skill my-skill Default Work

只把 skill 从 preset 中移除，不删除托管 skill 或 Agent 链接：

tm presets remove-skill my-skill Work

把一个 preset 里的所有 skills 移动到另一个 preset：

tm presets move Default Work

调整 preset 分组后，使用 tm presets apply 把当前分组写入 Agent skill 目录。

MCP Servers

添加 MCP server 到 Tools Manager：

tm mcp add playwright --command npx --arg @playwright/mcp@latest --tool codex

从 Agent 配置文件导入已有 MCP servers：

tm mcp add --tool codex
tm mcp add --tool all

列出托管的 MCP servers：

tm mcp list

列出当前本地 Agent 配置中的 MCP servers：

tm mcp list --tool codex
tm mcp list --tool all

查看某个托管 MCP server：

tm mcp show playwright

移除某个托管 MCP server：

tm mcp remove playwright

把托管 MCP servers 同步回 Agent 配置文件：

tm mcp sync
tm mcp sync --tool codex

只同步选定的 MCP servers：

tm mcp sync-selected playwright --tool codex
tm mcp sync-selected server-a server-b --tool all

无参数 tm 交互菜单支持该命令的多选和全选。

默认行为：

tm mcp sync 使用 --tool all
同步写入配置文件前会创建带时间戳的备份

支持的配置目标：

codex       -> ~/.codex/config.toml
claude_code -> ~/.claude/mcp.json
cursor      -> ~/.cursor/mcp.json
opencode    -> ~/.config/opencode/opencode.json

Backup

用 Git 备份托管 skills：

tm backup

如果需要，tm backup 会在 ~/.tools-manager/skills 中初始化 Git 仓库，提交 skill 变更；当 ~/.tools-manager/config.toml 中配置了 git_remote 时，还会执行 push。

命令参考

tm init
tm web [--port <port>] [--no-open] [--dev]
tm status [--json]
tm agents list [--tool <tool|all>] [--json]
tm skills add <source>
tm skills add --tool <tool|all>
tm skills list [--json]
tm skills list --tool <tool|all> [--json]
tm skills show <name> [--json]
tm skills remove <name> [--yes]
tm skills unlink <name> --tool <codex|claude_code|cursor|opencode>
tm skills sync-selected <name...> [--tool <tool|all>] [--mode <symlink|copy>]
tm skills sync [preset] [--tool <tool|all>] [--mode <symlink|copy>]
tm presets list [--json]
tm presets apply [preset] [--tool <tool|all>] [--mode <symlink|copy>]
tm presets move-skill <skill> <from> <to>
tm presets remove-skill <skill> <preset>
tm presets move <from> <to>
tm mcp add <name> --command <cmd> [--arg value] [--env K=V] [--tool <tool|all>]
tm mcp add --tool <tool|all>
tm mcp list [--json]
tm mcp list --tool <tool|all> [--json]
tm mcp show <name> [--json]
tm mcp remove <name>
tm mcp sync-selected <name...> [--tool <tool|all>]
tm mcp sync [--tool <tool|all>]
tm backup

支持的 tools：

codex
claude_code
cursor
opencode
all

开发

安装依赖并运行检查：

bun install
bun run check

本仓库通过 .npmrc 和 bunfig.toml 将 npm 与 Bun 安装固定到 npmmirror registry。

通过 package script 运行 CLI：

bun run tm status
bun run tm skills list

构建发布用的 CLI bundle：

bun run build
ls -la dist

需要保留 package.json 中的 bin 映射。它负责在 npm 全局安装后把 dist/cli.js 暴露为 tm 命令；删除后只能通过 package script 或直接执行文件来使用。

按用户实际使用方式测试 tm 二进制：

npm link
tm status
tm skills list
npm unlink -g tools-manager

发布

发布前：

bun run release:dry

检查 dry-run 输出。它应该只包含：

package.json
README.md
README.zh-CN.md
SKILL.md
dist/**
docs/**

发布：

bun run release

发布并自动升级版本：

bun run release:patch
bun run release:minor
bun run release:major

发布后，在干净 shell 中测试安装：

npm install -g tools-manager
tm --help
tm status

备注

tm skills add 支持本地文件夹、GitHub URL、内部 GitLab URL、SSH Git URL，以及 #ref:path/to/skill。
Git 认证交给本地 Git 配置处理：SSH keys、VPN、credential helpers 和 tokens。启用 2FA 的私有 HTTPS 仓库需要 personal access token，或改用 SSH Git URL。
tm skills add --codex 和 tm skills add --all 会作为兼容别名保留。
tm skills remove 会删除托管 skill 文件、移除 preset membership，并在确认后移除指向托管 source 的 Agent symlinks。
tm mcp remove 只会从 Tools Manager 删除 server；运行 tm mcp sync 后才会更新 Agent 配置文件。
--json 可用于 list/status 类命令，方便脚本调用。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme