SA

slash9494/ai-config-sync-manager

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

46 stars 7 forks 质量 77 趋势 33MIT

Claude 代码和 Codex 的双向同步——指令、技能、代理、MCP 服务器、钩子、权限。

概览

Claude Code 和 Codex 之间实现连续双向同步——往返无损,而非一次性迁移。 - — Claude → Codex 和 Codex → Claude,运行频率取决于两个主机漂移;非一次性迁移。- — Claude 宽松的 YAML 和 Codex YAML 1.2 严格前置文件均通过多次同步保存,无丢失或震动。- — 用于比较同步→状态 --试运行预览→-应用写入。- — 权限、钩子、标记为安全/部分/手动的自定义命令。- — 每次在 .backups/ 下快照的覆盖,FIFO 保留率(30)。- — 每个 --apply 为 ~/.ai-config-sync-manager/ledgers/ 写入每项 sha256 声明(哈希前后备份路径)。- — 包括技能:code-writer,instructions --排除 mcp 风格过滤。- — Claude Write → Codex sandbox_mode = “workspace-write”等。- — 仅 Claude 的令牌(Read、Bash、TaskCreate、无头 claude -p)和仅 Codex 的令牌(spawn_agent、Codex exec)会自动跨主机翻译并往返。

概述(AI 翻译)

AI 配置同步管理器

Claude Code 和 Codex 之间实现连续双向同步——往返无损,而非一次性迁移。

精彩片段

  • 连续双向同步 — claude → codex 和 codex → claude,运行频率取决于两个宿主漂移;不是一次性迁移。
  • 严格YAML往返 — Claude宽松的YAML和Codex YAML 1.2严格前置信息均通过多次同步保持无丢失或振荡。
  • 差分优先工作流程 — status用于比较→sync --dry-run用于预览→--apply用于写入。
  • 风险标记操作 — permissions、hooks,自定义命令标记为safe / partial / manual。
  • 写时备份 — 在.backups/下快照的每次覆写,FIFO保留率为30。
  • 应用账本 — 每个--apply都写入每项sha256证明(哈希前后,备份路径)到~/.ai-config-sync-manager/ledgers/。
  • 选择器语法 — --include skills:code-writer,instructions --exclude mcp 风格过滤。
  • 本地语义映射 — Claude Write → Codex sandbox_mode = "workspace-write"等。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

AI Config Sync Manager

Continuous bidirectional sync between Claude Code and Codex — round-trip lossless, not a one-shot migrator.

Highlights

  • Continuous bidirectional sync — claude → codex and codex → claude, run as often as the two hosts drift; not a one-shot migration.
  • Strict YAML round-trip — Claude lenient YAML and Codex YAML 1.2 strict frontmatter both preserved across repeated syncs without loss or oscillation.
  • Diff-first workflow — status to compare → sync --dry-run to preview → --apply to write.
  • Risk-tagged operations — permissions, hooks, custom commands labeled safe / partial / manual.
  • Backup-on-write — every overwrite snapshotted under .backups/, FIFO retention (30).
  • Apply ledger — every --apply writes a per-item sha256 attestation (before/after hash, backup path) to ~/.ai-config-sync-manager/ledgers/.
  • Selector syntax — --include skills:code-writer,instructions --exclude mcp style filtering.
  • Native semantic mapping — Claude Write → Codex sandbox_mode = "workspace-write", etc.
  • Prose-level token rewriting — Claude-only tokens (Read, Bash, TaskCreate, headless claude -p) and Codex-only tokens (spawn_agent, codex exec) auto-translate across hosts and round-trip back.
  • Zero runtime dependencies — single ESM file, Node built-ins only.
  • Thin host plugins — /config-manager:* for Claude, config-manager-* for Codex.
  • Visual inventory board — board renders a self-contained HTML page of every skill, agent, hook, and MCP server on both hosts, colored by sync status (in-sync / conflict / one-host-only) and grouped into per-area tabs and by agent harness. Jump to the board →
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →