⚡
🟤
🟢
🔵
🟡
🟣
🔴

One Config.
Six Agents.

Sync custom instructions, skills, and MCP servers across every AI coding CLI — write once, all six agents get the same config simultaneously.

Claude Code · Codex CLI · Copilot · Gemini CLI · Antigravity · OpenCode
$ npm i -g @bitkyc08/agent-sync copy
Get Started ⭐ GitHub
npm TypeScript Node MIT
scroll
how it works

Three Syncs,
Zero Hassle

agent-sync keeps your AI tool configuration consistent. Write once, sync everywhere.

📄

Custom Instructions

Auto-detects prompt files (AGENTS.md, CLAUDE.md, COPILOT.md, CODEX.md, etc.) and writes your unified instructions to 4 targets simultaneously:

→ AGENTS.md (Codex / OpenCode)
→ CLAUDE.md (Claude Code)
→ .github/copilot-instructions.md
→ .agents/rules/agent-sync.md (Antigravity)
project-level
🔗

Skills Sync

One .agent/skills/ directory is the source of truth. Symlinks are created so every agent discovers the same skills — no duplication, no drift.

src .agent/skills/ (real files)
→ .agents/skills/ (symlink)
→ .claude/skills/ (symlink)
project-level
🌐

MCP Servers

One ~/.agent-sync/mcp.json is synced to 6 different CLI config files with automatic format conversion — JSON for most, TOML for Codex.

src ~/.agent-sync/mcp.json
→ ~/.mcp.json (Claude)
→ ~/.codex/config.toml (TOML)
→ 4 more targets…
global
supported agents

Works With
Every Major CLI

Each agent gets its own native config format — instructions, skills, and MCP servers all synced at once.

🟤
Claude Code
JSON
~/.mcp.json
🟢
Codex
TOML
~/.codex/config.toml
🔵
Copilot
JSON
~/.copilot/mcp-config.json
🟡
Gemini CLI
JSON
~/.gemini/settings.json
🔴
Antigravity
JSON
~/.gemini/antigravity/mcp_config.json
🟣
OpenCode
JSON
~/.config/opencode/opencode.json
quick start

Up and Running
in 30 Seconds

An interactive wizard walks you through everything. No config files to create manually.

1

Install

Install globally from npm.

$ npm install -g @bitkyc08/agent-sync
2

Run

Launch the interactive wizard. It auto-detects your project and guides you through prompt, skills, and MCP setup.

$ agent-sync
3

Done ✓

All 6 agents now share the same config. Use individual commands for targeted syncs.

$ agent-sync mcp
$ agent-sync skills
$ agent-sync agents
mcp sync targets

One Source →
Six Destinations

Your ~/.agent-sync/mcp.json is automatically transformed and written to each CLI's native format.

Target Config Path Format
Claude Code ~/.mcp.json JSON mcpServers
Codex ~/.codex/config.toml TOML [mcp_servers.*]
Gemini CLI ~/.gemini/settings.json JSON mcpServers
OpenCode ~/.config/opencode/opencode.json JSON mcp
Copilot ~/.copilot/mcp-config.json JSON mcpServers
Antigravity ~/.gemini/antigravity/mcp_config.json JSON mcpServers

Config Location

All agent-sync data lives in ~/.agent-sync/. The unified MCP config is your single source of truth. Backups are created automatically when conflicts are detected.

~/.agent-sync/
├── mcp.json # unified MCP source of truth
└── backups/ # auto-backups on conflict