convez.ai
SkillDevOps & InfraestruturaIntermediário
lllloo

AI Config Sync

lllloo/ai-config-sync

Sincronize configs Claude/Codex entre máquinas via Git privado

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta Git para sincronizar configurações, agents, skills e rules do Claude Code/Codex entre múltiplos dispositivos. Mantém um repositório privado como fonte única de verdade para todos os seus ambientes.

Instalação

$npx convez-ai lllloo/ai-config-sync

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Manter configurações do Claude Code sincronizadas entre laptop, desktop e servidor
  • Versioná-lo skills e agents globais com controle de mudanças
  • Onboarding de novo equipamento sincronizando todas as personalizações em um comando

Veredito

Solução prática e bem estruturada para quem trabalha com Claude em múltiplos ambientes. Implementação direta sem dependências externas e com testes inclusos tornam confiáveis as sincronizações críticas de configuração.

README

A tradução para o português deste README ainda está na fila.

ai-config-sync

跨裝置同步 Claude Code / Codex 設定的私有 Git repo 工具。

這是一個 GitHub Template:點 Use this template 建立自己的私有 repo,再執行 npm run init 清空作者範例後填入自己的設定。詳見下方「Fork 後初次設定」。

同步項目:~/.claude/CLAUDE.md、~/.claude/settings.json、~/.claude/statusline.sh、全域 agents、全域 skills、全域 rules、~/.codex/AGENTS.md、~/.codex/config.toml(過濾版)、~/.codex/agents/

目錄命名:

  • claude/(無點)— 要同步到 ~/.claude/ 的全域設定
  • codex/(無點)— 要同步到 ~/.codex/ 的全域設定(AGENTS.md、config.toml、agents)
  • .claude/、.codex/ — 本 repo 專用的 Claude Code / Codex 本地設定,不參與同步
  • .agents/skills/ — 本地 skill 實體目錄(已納入版控),.claude/skills 與 .codex/skills 皆為 symlink 指向此處,跨工具共用

使用方式

# 比較本機 vs repo 差異(不寫任何東西)
npm run diff

# 同時比較設定與 skills 差異
npm run status

# 本機設定 → repo(上傳)
npm run to-repo

# repo 設定 → 本機(套用,會先預覽再確認)
npm run to-local

# 比較本機 vs repo 的 skills 差異(不自動同步)
# 本機多裝者會同時列出 (A) 加入 repo 與 (B) 從本機移除 兩種建議指令
npm run skills:diff

# 新增 skill 到 skills-lock.json
npm run skills:add -- https://skills.sh/<org>/<repo>/<skill>
npm run skills:add -- <name> <source>

# 從 skills-lock.json 移除 skill
npm run skills:remove -- <name>

# 執行單元測試(node:test,零外部相依)
npm test

指令別名

可直接用 node sync.js 搭配簡寫:

指令別名
diffd
statuss
to-repotr
to-localtl
skills:diffsd
skills:addsa
skills:removesr
init—

旗標

旗標說明
--dry-run預覽操作,不實際寫入(適用 to-repo / to-local)
--verbose顯示詳細路徑與檔案大小
--version顯示版本號
--help顯示指令說明
# 範例:預覽 to-repo 會做什麼,不實際寫入
node sync.js to-repo --dry-run

# 範例:顯示詳細差異資訊
node sync.js diff --verbose

Fork 後初次設定

如果你是從 template 建立自己的 repo(而不是回到自己已有的設定 repo),執行以下流程清空作者範例:

# 1. 從 template 建立自己的 repo 後 clone
git clone <your-new-repo-url>
cd <your-new-repo>

# 2. 清空作者個人內容為空骨架(會互動確認,可加 --dry-run 預覽)
npm run init

# 3. 修改 package.json 的 name 與 description 為你自己的
# 4. 在主力機把本機現有設定推上 repo
npm run to-repo
git add . && git commit -m "init: my settings" && git push

# 5. 其他裝置 clone 後直接 to-local 即可

npm run init 會:

  • 把 claude/CLAUDE.md、codex/AGENTS.md、claude/settings.json、skills-lock.json 重置為空骨架(由 .example 範本覆寫)
  • 刪除 claude/rules/ 下作者個人化規則檔
  • 不會動 claude/agents/、codex/agents/、claude/skills/、.agents/skills/、sync.js、test/(這些對所有人都有用)

新裝置部署

如果你已經完成 Fork 後初次設定,第二台之後的機器只要:

git clone <your-repo-url>
cd <your-repo>
npm run to-local

檔案說明

檔案說明
sync.js主腳本,實作所有指令邏輯(無外部相依)
test/sync.test.js同步邏輯純函式單元測試(使用 Node.js 內建 node:test)
test/settings.test.jssettings.json 相關純函式單元測試
test/codex-config.test.jsCodex config.toml 過濾同步測試
package.json定義所有 npm 指令
claude/CLAUDE.md對應 ~/.claude/CLAUDE.md
claude/settings.json對應 ~/.claude/settings.json
claude/statusline.sh對應 ~/.claude/statusline.sh
claude/agents/對應 ~/.claude/agents/(以 package 子目錄組織)
claude/skills/對應 ~/.claude/skills/
claude/rules/對應 ~/.claude/rules/(CLAUDE.md 的模組化拆分,支援 frontmatter paths: 做 path-specific scoping)
codex/AGENTS.md對應 ~/.codex/AGENTS.md(Codex 全域指示,跨專案規則)
codex/config.toml對應 ~/.codex/config.toml 的可攜欄位(過濾版)
codex/agents/對應 ~/.codex/agents/(以 package 子目錄組織,.toml 格式)
skills-lock.json全域 skills 清單(跨裝置 source of truth)
claude/CLAUDE.example.mdFork 後 npm run init 用的空骨架範本
claude/settings.example.json同上,設定檔範本(僅基本 permissions)
codex/AGENTS.example.md同上,Codex 全域指示範本
skills-lock.example.json同上,空 skills 清單範本

Exit Code

Code說明
0成功(diff 模式:無差異)
1diff 模式:有差異(可用於 CI 判斷)
2錯誤

注意事項

  • settings.json 的 model、effortLevel、defaultShell、env.CLAUDE_CODE_USE_POWERSHELL_TOOL 為裝置特定設定,to-repo 時自動排除,to-local 時保留本機值;env 其他 key 皆跨裝置同步
  • codex/config.toml 只同步可攜欄位:personality、web_search、tui.status_line、features.memories、features.goals、memories.generate_memories、memories.use_memories、plugins.*.enabled
  • codex/config.toml 會排除 model、model_reasoning_effort、projects.*、marketplaces.*、windows、tui.model_availability_nux 與未知欄位;to-local 時保留本機未受管理欄位
  • .agents/skills/ 是本地 skill 實體目錄,已納入版控;.claude/skills 與 .codex/skills 以 symlink 共用同一份來源
  • Claude agents 儲存於 claude/agents/,以 package 子目錄分組(awesome-claude-code-subagents/、everything-claude-code/);Codex agents 儲存於 codex/agents/,同樣以 package 子目錄分組(awesome-codex-subagents/),Codex CLI 會遞迴掃描子目錄
  • Skills 不在自動同步範圍內,用 npm run skills:diff 查看差異;本機多裝者會列出 npm run skills:add(加入 repo)與 npx skills remove(從本機移除)兩種建議
  • JSON 寫入使用 atomic write(先寫暫存檔再 rename),避免中途斷電導致檔案損壞
  • 每次 to-repo / to-local 操作會記錄到 .sync-history.log(已加入 .gitignore)
Ver o original no GitHub

Bom para

Relacionados