AI导哈

配置同步工具

一个跨工具配置同步的代理技能，使Claude Code、OpenCode、Codex和Cursor共享相同的技能和MCP服务器配置。

  • by liamdmcgarrigle
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 liamdmcgarrigle/agent-config-sync

使用说明

代理配置同步

一种设置跨工具配置同步的代理技能，以便 Claude代码、OpenCode、Codex和游标 它们共享相同的技能和MCP服务器。

克劳德密码是唯一的真理来源。更改通过以下方式自动传播到所有其他工具 垂直同步 还有git钩子。

安装

npx skills add liamdmcgarrigle/agent-config-sync --copy

或安装到特定代理：

npx skills add liamdmcgarrigle/agent-config-sync -a claude-code --copy

为什么 --copy? 此技能使用 垂直同步 跨工具同步技能。vsync不能跟随符号链接，因此技能必须作为真实文件复制。没有 --copy，技能CLI创建符号链接，vsync会自动跳过这些符号链接。

Alternative: git submodule

对于在您的仓库中跟踪的版本固定安装：

git submodule add https://github.com/liamdmcgarrigle/agent-config-sync.git .claude/skills/agent-config-sync

它做什么

安装后，要求您的代理“设置代理同步”，它将：

  1. 配置vsync --创建 .vsync.json 将技能、MCP服务器、代理和命令从Claude Code同步到Cursor、OpenCode和Codex
  2. 设置git挂钩 --每次提交后自动同步的提交后挂钩，保持 AGENTS.md 同步 CLAUDE.md，以及一个预提交钩子，用于在检测到仅支持Claude Code的插件时发出警告
  3. 搜索和安装技能 --用途 npx skills （从 技能s.sh)查找技能并将其安装到Claude Code，然后同步到所有工具
  4. 搜索并添加MCP服务器 --将服务器添加到 .mcp.json 并与每个工具的自动格式转换（JSON/TOML/JSONC）同步
  5. 管理技能子模块 --对于版本固定，团队通过git子模块共享技能
  6. 更新所有内容 --一个工作流，用于更新所有技能、子模块和重新同步

工作流

工作流 它做什么
setup-agent-sync 一次性项目设置（vsync、git挂钩、初始同步）
find-skill 搜索skills.sh，安装到Claude Code，同步到所有工具
add-skill-submodule 添加技能库作为版本固定的git子模块
find-mcp 搜索MCP注册表，添加服务器，同步到所有工具
update-agent-tools 更新所有技能+子模块+重新同步

运作原理

Claude Code (.claude/)          -- SOURCE OF TRUTH
    |
    | npx @nicepkg/vsync sync
    |
    +---> Cursor (.cursor/)
    +---> OpenCode (.opencode/)
    +---> Codex (.codex/)

技能使用通用 代理技能 SKILL.md格式，适用于所有四种工具。MCP服务器配置由vsync自动在格式之间转换。

后提交钩子也保持 AGENTS.md 同步 CLAUDE.md。如果您更新了您的 CLAUDE.md，钩子会自动将其复制到 AGENTS.md 并提交更改，因此两个文件的内容始终相同。

需求

  • Node.js （适用于npx）
  • git仓库

vsync和npx技能是通过npx运行的，不需要全局安装。

许可证

麻省理工学院

相关 MCP