Jakubantalik
Featured
thinking-orbs
A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.
agents-sync
A tool that synchronizes configuration files (CLAUDE.md, AGENTS.md, skills, hooks, MCP, etc.) between Claude Code and Codex to prevent settings divergence, using symlinks and bidirectional conversion where formats differ.
Stars
7
7-day growth
No data
Forks
0
Open issues
0
License
MIT
Last updated
2026-07-28
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It solves a practical problem of configuration drift when using multiple AI coding agents, offering safe interactive setup, backup/restore, and optional automatic sync, with careful handling of format differences and platform-specific caveats.
Who it is for
- Developers using Claude Code and Codex simultaneously
- Teams sharing project-level agent configurations
- Power users wanting to avoid manual sync and drift
Use cases
- Synchronizing project-specific settings (skills, CLAUDE.md, MCP) across Claude and Codex
- Applying global settings to both agents at once
- Automatically detecting and syncing changes on macOS to prevent divergence
Strengths
- Interactive and safe: shows diffs, asks for confirmation, offers backups before changes
- Supports multiple config types: skills, CLAUDE.md/AGENTS.md, hooks, MCP, subagents, rules
- Automatic sync on macOS via launchd and fswatch, with a notification-only mode
- Respects harness limitations: skips items not supported by one agent (e.g., SessionEnd hook in Codex)
Considerations
- Automatic sync only works on macOS (requires launchd & fswatch)
- Requires Bun runtime and may have TOML parser edge cases (multi-line string handling)
- Windows symlink support depends on Developer Mode; git symlinks may become plain text files
README quick start
agents-sync
Claude Code と Codex に分かれてしまった設定を、1つにまとめて、以後ずれないように同期するツールです。
CLAUDE.md と AGENTS.md、.claude/skills/ と .agents/skills/ のように、 同じ内容が2か所に置かれていると、使用するコーディングエージェントごとに設定が独自に分岐していってしまいます。(= 意図した分岐であればよいですが、片方の変更がもう片方に同期されない、ということが起きます)
agents-sync は、片方を実ファイル・もう片方をSymlink(同じファイルを参照させる)にすることで、この分岐をなくします。
対応ツール / モード
| 項目 | 対応 |
|---|---|
| ハーネス | Claude Code / Codex |
| 手動同期 | macOS / Linux / Windows |
| 自動同期 | macOS（launchd） |
インストール
一度だけ行う作業です。
1. ダウンロードする
ダウンロードした ZIP を展開してください。置き場所はどこでも構いません。
2. セットアップする
展開したフォルダをそのままClaude CodeまたはCodexに渡して、「これを導入して」と指示してください。どちらに渡しても構いません。 セットアップは両方のツールに登録するので、以後はClaude CodeとCodexのどちらからでも呼び出せます。
エージェント向けの手順: 展開先のフォルダで
bun src/cli.ts setupを実行して登録状況を表示し、内容をユーザーに見せて確認を得てからbun src/cli.ts setup --applyで登録します。登録の向きはスキル同期と同じ規約です。~/.claude/skills/agents-syncが展開先のskill/フォルダを指し、~/.codex/skills/agents-syncはその~/.claude/skills/agents-syncを指します（実体は展開先の1つだけ）。
注意：スキルはマシンに1つだけ入れる
agents-sync は、マシンに1つだけ入れる前提のスキルです。 対象が1つのプロジェクトだけであっても、プロジェクトの中にコピーせず、上記のセットアップ（~/.claude/skills/ と ~/.codex/skills/ への登録）を使ってください。
- 中身がプロジェクトに依存しません … 書かれているのは agents-sync の操作手順で、 どのプロジェクトでも同じです。プロジェクトごとに変わるのは設定ファイルです
- プロジェクトに置くと、自分自身が同期対象になります …
.claude/skills/agents-sync/に置くと、 agents-sync がそれを.agents/skills/へリンクし、ツールの説明書がそのリポジトリに コミットされてしまいます - プロジェクトに置くと、agents-sync 自身が居場所を見失います … スキルは
~/.claude/skills/agents-sync（または~/.codex/skills/agents-sync）を手がかりに、自分の本体がどこにあるかを割り出しています
操作の流れ
セットアップ後、エージェントに実行を頼むと、以下の流れで作業を進めてくれます。
最初に、どこへ入れるかを聞かれます
対象によって書き換える範囲がまったく違うため、実行前に聞かれるようになっています。
| 選択肢 | 何をするか |
|---|---|
| 特定のプロジェクト内への導入（推奨） | 1つのプロジェクトだけが対象です。設定はそのプロジェクトの中に作られ、他には一切影響しません |
| グローバル設定の変更 | ~/.claude と ~/.codex（全プロジェクト共通の設定）が対象です |
| 全プロジェクトへの導入 | マシン全体を探して、見つかったプロジェクトを1件ずつ片付けます。時間が掛かります |
初めて使うときは、特定のプロジェクト内への導入から始めるのが安全です。 影響がそのプロジェクトの中で閉じているので、気に入らなければそこだけ元に戻せます。
次に、いまの差分が表示されます
まず、Skills・CLAUDE.md / AGENTS.md・MCP などの項目ごとに、 両ツールの設定がどれだけ食い違っているかの一覧が表示されます。ここでは表示だけで、まだ何も変わりません。
何をまとめるかを聞かれます
一覧を見たうえで、まとめる対象を選べます。すべてそのままで進めても、安全な既定になっています。 この時点ではまだ同期されません。
次に「実ファイルをどちら側に置くか」を聞かれます。項目ごとではなく、プロジェクト共通の設定です。 Claude 側（.claude/CLAUDE.md・.claude/skills/）が既定で、Codex 側（`AGE
Description
Claude Code と Codex の設定を1つに保つ同期ツール（symlink + 双方向変換）
Related repositories
Similar projects matched by category, topics, and programming language.
makecindy
Featured
cindy
Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.
mereyabdenbekuly-ctrl
Featured
clodex-ide
Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.