AgentSync


> Stop copying configs between AI coding tools. Sync them all with one command.

😫 The Problem

Are you tired of:

- Copying .cursor/rules to .claude/ every time you update coding standards?
- Maintaining separate configs for Cursor, Claude, Cline, and Roocode?
- Team members using outdated AI agent configurations?
- No way to share MCP servers across different tools?

You're losing 30+ minutes per week on manual config management.

✨ The Solution

AgentSync is the infrastructure layer that keeps all your AI coding tools in perfect sync.

``bash


Before: Manual chaos 😰

cp ~/.cursor/rules/* ~/.claude/rules/
cp ~/.cursor/rules/* ./.clinerules/

Oops, forgot Roocode... and wait, .mdc needs to be .md...

After: One command, everything synced ✅

agentsync sync
✓ Synced to Cursor, Claude, Cline, Roocode
`

🚀 What You Get

$3

- Never copy config files again — One source of truth for all AI tools
- Tool flexibility — Switch between Cursor, Claude, Cline seamlessly
- Smart format conversion — Automatically handles .mdc ↔ .md conversions
- MCP server management — Share context servers across all tools

$3

- Instant standardization — Push coding standards to entire team at once
- GitHub-based presets — Share rules via github:company/standards
- No more drift — Everyone uses the same prompts and commands
- Security by default — Built-in secret scanning prevents API key leaks

$3

- Compliance ready — Audit logs for all configuration changes
- Preset composition — Layer company, team, and project standards
- Tool agnostic — Works with whatever AI tools your teams prefer
- Progressive adoption — Teams can migrate at their own pace

📊 Before vs After

| Task | Before AgentSync | With AgentSync |
| --------------------------- | --------------------------------- | ------------------------------------- |
| Update coding standards | Edit 4+ config files manually ❌ | Edit once, run agentsync sync ✅ |
| Share team prompts | Copy/paste in Slack ❌ | extends: ["github:team/prompts"] ✅ |
| New team member setup | 20 minutes of copying files ❌ | agentsync init - 30 seconds ✅ |
| Add MCP server to all tools | Configure each tool separately ❌ | Add to mcpServers, sync once ✅ |
| Switch between AI tools | Recreate all configurations ❌ | Already synced automatically ✅ |

⚡ Quick Start

$3

`bash
npm install -g agentsync


or


pnpm add -g agentsync
`

$3

`bash


Initialize in your project

agentsync init

Import existing configs (optional)

agentsync import ~/.cursor # Import from Cursor
agentsync import . # Auto-detect and import

Sync everything

agentsync sync
`

That's it! Your AI tools are now synchronized.

🎯 Real-World Example

Your team uses Cursor, but you prefer Claude. Another developer uses Roocode. Here's how AgentSync helps:

.agentsync/config.json (shared via git):

`json
{
"extends": [
{
"source": "github:acme/coding-standards",
"namespace": "company"
}
],
"tools": ["cursor", "claude", "roocode"],
"mcpServers": ["github", "postgres"]
}
`

Now everyone has:

- ✅ Same coding standards across all tools
- ✅ Same slash commands (/test, /review, /commit)
- ✅ Same MCP servers for enhanced context
- ✅ Tool-specific format compatibility (.mdc for Cursor, .md for others)

🛠️ Core Features

$3

- One source, multiple targets — Define once in .agentsync/
- Format intelligence — Handles .mdc, .md, nested/flat structures
- Bidirectional codecs — Import from any tool, export to any tool

$3

Share and compose configurations across teams:

`json
{
"extends": [
{ "source": "github:company/standards", "namespace": "company" },
{ "source": "github:team/frontend", "namespace": "frontend" },
{ "source": "fs:./local-overrides", "namespace": "local" }
]
}
`

$3

Configure Model Context Protocol servers once, use everywhere:

`json
{
"mcpServers": ["github", "postgres", "filesystem"]
}
`

$3

- Reference mode — Try AgentSync without moving files
- Import mode — Full migration with automatic backups
- Tool detection — Automatically finds existing configs

$3

- Secret scanning — Prevents accidental API key commits (enabled by default)
- Unicode detection — Blocks hidden character attacks
- Audit logging — Track all configuration changes
- Local-first — Your data never leaves your machine

📦 Supported Tools

| Tool | Rules | Commands | MCP Servers | AGENTS.md |
| ----------- | ------------------------ | -------------------------- | ----------- | --------- |
| Cursor | ✅ .cursor/rules/.mdc | ✅ .cursor/commands/.md | ✅ | ✅ |
| Claude | ✅ .claude/rules/.md | ✅ .claude/commands/.md | ✅ | ✅ |
| Cline | ✅ .clinerules/*.md | ❌ Not supported | ✅ | ✅ |
| Roocode | ✅ .roo/rules/.md | ✅ .roo/commands/.md | ✅ | ✅ |

🎮 Commands

`bash


Initialize AgentSync

agentsync init

Check configuration status

agentsync status

Import existing configs

agentsync import ~/.cursor # From global Cursor config
agentsync import . # Auto-detect project configs

Sync configurations

agentsync sync # Sync everything
agentsync sync --pull # Update presets first

Manage presets

agentsync preset list # Show available presets
agentsync preset select # Interactive preset selection
agentsync preset add github:org/repo

Manage MCP servers

agentsync mcp list # Show available MCP servers
agentsync mcp enable github # Enable a specific server
`

📚 Documentation

- Getting Started: See Quick Start above
- Requirements & Design: REQUIREMENTS.md
- Configuration Guide: docs/configuration.md
- Preset System: docs/presets.md
- CLI Reference: docs/cli.md
- Testing: TESTING.md
- Architecture: ARCHITECTURE.md

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

🔒 Security

- Local-first: Your configurations never leave your machine
- Secret scanning: Built-in detection for API keys and tokens
- Audit trail: Complete history of all configuration changes
- No telemetry: We don't track usage or collect data

See SECURITY.md for details.

📝 License

MIT — Use it freely in personal and commercial projects.

---

Ready to save 30+ minutes per week?

`bash
npm install -g agentsync && agentsync init
``

_Stop managing configs. Start shipping code._ 🚀