agent-compose

把 agent-compose.yaml 里的 MCP 和 Skill，安装到 Cursor、Claude 或 Codex。

需要 Node.js ≥ 18。

安装

npm install -g agent-compose

快速上手

agent-compose init
# 已写出 ./agent-compose.yaml
agent-compose apply

只装某一个 Skill（没有 yaml 会自动写出最小文件）：

agent-compose apply skill env/moss

未写 catalog.uri 时使用本包内 Catalog。写了 uri 或 --catalog-uri 则走该 Git / 本地路径。

无 --dir → 用户级（Cursor：~/.cursor/；Claude：~/.claude.json；Codex：~/.codex/config.toml）。
有 --dir <项目根> → 该项目下的对应目录。

命令

agent-compose list
agent-compose cat host-execution
agent-compose search k8s
agent-compose apply skill env/moss --dir /path/to/project
agent-compose apply --dir /path/to/project

| 命令 | 作用 | |------|------| | init | 拷贝示例 yaml 到 ./agent-compose.yaml | | list [mcp\|skill] | 列出 Catalog | | cat <package> | 打印该包源文件 | | search <keyword> | 搜索 | | apply [file] | 按 yaml 安装 | | apply skill <名…> / apply mcp <id…> | 并进 yaml 再安装；-t / --target 选 IDE | | plan / doctor | 对照 / 检查落点 | | reconstruct | 从 lock + 目标 MCP 配置重建 yaml |

target 可为 cursor / claude / codex。Codex 的 MCP 写入 config.toml 的 [mcp_servers.<name>]，不是 JSON。yaml 里 <键名> 占位不会写进落点，也不覆盖已填密钥。

完整说明：CLI、yaml。