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
🖥️ Machine Setup - Opinionated development dependencies for macOS/Linux
🌍 Cross-Platform - macOS, Linux (Windows coming soon)

Quick Start

Option 1: npx (No Install Required)

npx @donnes/syncode new

Already Have a Repo?

syncode init

Option 2: Global Install

# Install globally
npm install -g @donnes/syncode

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

# Initialize
syncode new

Usage

Initialize a New 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.)

Initialize from an Existing Repo

syncode init

This will:

Prompt for the repo URL and local storage path
Clone the repo if needed
Let you choose which agents to sync
Save configuration to ~/.syncode/config.json

Sync Agents Config

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
Option to run full machine status

Machine Dependencies

syncode machine deps

Install opinionated development dependencies for your machine:

macOS: Homebrew packages from Brewfile
Arch/Omarchy: Pacman/yay packages from packages-arch.txt
Debian/Ubuntu: APT packages from packages-debian.txt
Universal: Bun runtime and latest Node.js via fnm

These are boilerplate files that get copied to your repo root during syncode new. Edit them to customize the packages for your workflow.

Machine Status

syncode machine status

Shows comprehensive machine setup status:

Platform and package manager detection
Repository and git status
Dependency file presence
Quick health check for your development environment

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": "~/.syncode/repo",
  "remote": "https://github.com/<username>/configs.git",
  "agents": ["opencode", "claude", "cursor", "windsurf"],
  "features": {
    "autoSync": false,
    "backupBeforeExport": true,
    "smartSyncDefaults": true
  }
}

Repository Structure

~/.syncode/repo/
├── .git/
├── .gitignore
├── Brewfile
├── packages-arch.txt
├── packages-debian.txt
├── 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

Commands

syncode new - Initialize a new agent config repository
syncode init - Initialize from an existing 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 machine deps - Install machine dependencies (brew/apt packages, bun, node)
syncode machine status - Show full machine setup status
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
# Or connect to an existing repo
syncode init

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

Support

Made with ❤️ for developers

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
.github		.github
docs/agents		docs/agents
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
ROADMAP.md		ROADMAP.md
biome.json		biome.json
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts

License

donnes/syncode

Folders and files

Latest commit

History

Repository files navigation

syncode - Agent Configuration Manager

Why syncode?

Features

Quick Start

Option 1: npx (No Install Required)

Already Have a Repo?

Option 2: Global Install

Usage

Initialize a New Repo

Initialize from an Existing Repo

Sync Agents Config

Check Status

Machine Dependencies

Machine Status

Push to Remote

Supported Agents

Configuration

Repository Structure

Usage Examples

Daily Workflow

Commands

Development

Building from Source

Running Tests

Platform Support

Requirements

Troubleshooting

Configuration not found

Symlinks not working

Contributing

License

Support

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 7

Packages 0

Languages

Packages