@donnes/syncode

syncode - Agent Configuration Manager

Stop fighting with AI agent configurations. Sync your Claude Code, Cursor, Windsurf, OpenCode, and VSCode settings across machines and projects with a single command.

The era of AI-powered coding is here, but managing multiple AI assistants is a mess. syncode solves this.

Why syncode?

The Problem: You use Cursor at work, Claude Code for side projects, and want to try Windsurf or Roo Code. Each has its own config format and setup. Keeping 17+ AI agents in sync is manual hell.

The Solution: syncode is your single source of truth for AI agent configurations.

Features

• 🤖 17+ AI Agents - Claude Code, Cursor, Windsurf, OpenCode, VSCode, GitHub Copilot, Roo Code, Goose, Gemini CLI, Amp, Kilo Code, Kiro CLI, Trae, Codex, Antigravity, Clawdbot, Droid
• 🔄 Smart Sync - Automatic detection and sync with smart defaults per agent
• 🔗 Symlinks & Copy - Symlinks for live sync, copy for Claude (preserves cache)
• 📦 Version Control - Git-based workflow for your AI configurations
• 🛡️ Safe Operations - Automatic backups before any changes
• 🌍 Cross-Platform - macOS, Linux (Windows coming soon)

Quick Start

Option 1: npx (No Install Required)

npx @donnes/syncode new

Option 2: Global Install

# Install globally
npm install -g @donnes/syncode

# Or using bun
bun install -g @donnes/syncode

# Initialize
syncode new

Usage

Initialize New Agent Config Repo

syncode new

This will:

• Auto-detect installed AI agents (17+ agents supported)
• Let you select which agents to sync
• Create a git repository for your configs
• Import your existing configs
• Set up smart sync defaults (symlinks for most, copy for Claude, Gemini, etc.)

Sync Agent Configs

syncode sync

Choose direction:

• Import: Copy configs from system to repo (before committing changes)
• Export: Sync configs from repo to system (on new machines)

Check Status

syncode status

Shows:

• Which agents are synced
• Sync method (symlink vs copy)
• Git status

Push to Remote

syncode push

Push your config changes to the remote repository:

• Detects uncommitted changes
• Optionally commits changes with a message
• Pushes to the configured remote branch

Supported Agents

Agent	Config Path	Sync Method	Auto-Detect
Amp	~/.config/amp	Symlink	✅ Yes
Antigravity	~/.gemini/antigravity	Copy	✅ Yes
Claude Code	~/.claude	Copy	✅ Yes
Clawdbot	~/.clawdbot	Symlink	✅ Yes
Codex	~/.codex	Symlink	✅ Yes
Cursor	~/Library/Application Support/Cursor/User	Symlink	✅ Yes
Droid	~/.factory	Symlink	✅ Yes
Gemini CLI	~/.gemini	Copy	✅ Yes
GitHub Copilot	~/.copilot	Copy	✅ Yes
Goose	~/.config/goose	Symlink	✅ Yes
Kilo Code	~/.kilocode	Symlink	✅ Yes
Kiro CLI	~/.kiro	Symlink	✅ Yes
OpenCode	~/.config/opencode	Symlink	✅ Yes
Roo Code	~/.roo	Symlink	✅ Yes
Trae	~/.trae	Symlink	✅ Yes
VSCode	~/Library/Application Support/Code/User	Symlink	✅ Yes
Windsurf	~/.codeium/windsurf	Symlink	✅ Yes

Configuration

Global configuration is stored at ~/.syncode/config.json:

{
  "version": "1.0.0",
  "repoPath": "~/agent-configs",
  "remote": "[e-mail]:username/agent-configs.git",
  "agents": ["opencode", "claude", "cursor", "windsurf"],
  "features": {
    "autoSync": false,
    "backupBeforeExport": true,
    "smartSyncDefaults": true
  }
}

Repository Structure

~/agent-configs/
├── .git/
├── .gitignore
├── README.md
└── configs/
    ├── amp/               # Symlinked
    ├── antigravity/       # Copy sync
    ├── claude/            # Copy sync (preserves cache)
    ├── clawdbot/          # Symlinked
    ├── codex/             # Symlinked
    ├── cursor/            # Symlinked
    ├── droid/             # Symlinked
    ├── gemini-cli/        # Copy sync
    ├── github-copilot/    # Copy sync
    ├── goose/             # Symlinked
    ├── kilo/              # Symlinked
    ├── kiro-cli/          # Symlinked
    ├── opencode/          # Symlinked
    ├── roo/               # Symlinked
    ├── trae/              # Symlinked
    ├── vscode/            # Symlinked
    └── windsurf/          # Symlinked

Usage Examples

Daily Workflow

# Edit your AI agent configs normally
# Example: ~/.config/opencode/opencode.json
# Example: ~/.claude/skills/my-helper.md
# Changes are synced via symlinks automatically

# Check what changed
syncode status

# Import changes to repo
syncode sync
# Select "Import"

# Push to remote (commits and pushes in one command)
syncode push

New Machine Setup

# Install syncode
npm install -g @donnes/syncode

# Clone your agent config repo
git clone https://github.com/username/agent-configs.git ~/agent-configs

# Sync configs (creates symlinks)
cd ~/agent-configs
syncode sync
# Select "Export"

# You're ready - all AI agents configured identically!

Commands

• syncode new - Initialize a new agent config repository
• syncode sync - Sync agent configs (import or export)
• syncode status - Show status of synced agents
• syncode push - Push config changes to git remote
• syncode --version - Show version
• syncode help - Show help message

Development

Building from Source

# Clone the repository
git clone https://github.com/donnes/syncode.git
cd syncode

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build for production
bun run build

# Link locally
bun link

Running Tests

# Type check
bun run typecheck

# Build
bun run build

Platform Support

Platform	Status	Notes
macOS	✅ Fully Supported	Primary development platform
Linux	✅ Fully Supported	Tested on Ubuntu, Arch
Windows	🚧 Planned	Coming soon

Requirements

• Node.js >= 20.0.0 or Bun >= 1.0.0
• Git (for repository management)
• macOS or Linux

Troubleshooting

Configuration not found

# Run initialization
syncode new

Symlinks not working

# Check configuration health
syncode status

# Re-export configs
syncode sync
# Select "Export"

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

MIT © Donald Silveira

Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions
• 📦 npm Package

Made with ❤️ for developers