代理配置同步
一种设置跨工具配置同步的代理技能，以便 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它做什么
安装后，要求您的代理“设置代理同步”，它将：
- 配置vsync --创建
.vsync.json将技能、MCP服务器、代理和命令从Claude Code同步到Cursor、OpenCode和Codex - 设置git挂钩 --每次提交后自动同步的提交后挂钩，保持
AGENTS.md同步CLAUDE.md，以及一个预提交钩子，用于在检测到仅支持Claude Code的插件时发出警告 - 搜索和安装技能 --用途
npx skills（从 技能s.sh)查找技能并将其安装到Claude Code，然后同步到所有工具 - 搜索并添加MCP服务器 --将服务器添加到
.mcp.json并与每个工具的自动格式转换（JSON/TOML/JSONC）同步 - 管理技能子模块 --对于版本固定，团队通过git子模块共享技能
- 更新所有内容 --一个工作流，用于更新所有技能、子模块和重新同步
工作流
| 工作流 | 它做什么 |
|---|---|
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 并提交更改，因此两个文件的内容始终相同。
需求
- （适用于npx）
- git仓库
vsync和npx技能是通过npx运行的，不需要全局安装。
许可证
麻省理工学院