AI Sync

Universal sync tool for AI coding agents and IDEs. Never lose context when switching tools.

The Problem

You're deep in a conversation with Claude Code, building a complex feature. Then:

• The session hits the token limit
• You need to switch to VS Code for debugging
• Your colleague uses Copilot and needs your context

Without AI Sync: You lose everything. Start over, re-explain, lose hours.

With AI Sync: Your conversation travels with you. Seamless handoff between any AI tool.

Quick Start

# Install
npm install -g ai-sync-cli

# Sync from Claude to VS Code (direct, no subcommand needed)
ai-sync --from claude --to vscode --path ./my-project

How It Works

Claude Code ──────► VS Code
     │                   │
     └───── AI Sync ─────┘
              │
     ┌───────┴───────┐
     ▼               ▼
   Cursor       JetBrains

Installation

# npm
npm install -g ai-sync-cli

# yarn
yarn global add ai-sync-cli

# pnpm
pnpm add -g ai-sync-cli

# No install? Use npx
npx ai-sync --from claude --to vscode --path ./project

Sync Modes

AI Sync offers multiple ways to sync depending on your workflow:

1. Direct Sync (Point to Point)

Sync from one specific agent to one specific IDE:

# Basic syntax
ai-sync --from <agent> --to <ide> --path ./project

# Examples
ai-sync --from claude --to vscode --path ./my-app
ai-sync --from copilot --to jetbrains --path ./backend
ai-sync --from gemini --to cursor --path ./ai-project
ai-sync --from windsurf --to opencode --path ./workspace

2. Central Mode (One Source, Many Targets)

Use ANY agent as the central source. AI Sync detects all other agents/IDEs in the project and syncs from the central one to all of them:

# Use Claude as central source (syncs to ALL detected tools)
ai-sync --central claude

# Use Copilot as central source
ai-sync --central copilot

# Use WindSurf as central source
ai-sync --central windsurf

# Works with ANY supported agent:
# claude, copilot, gemini, cursor, windsurf, aider, continue,
# amazonq, codex, devin, replit, and 15+ more

How Central Mode works:

    ┌─────────────┐
    │   (any)     │  ← You choose: claude, copilot, gemini, etc.
    │   Agent     │  ← This becomes the central source
    └──────┬──────┘
           │
    ┌──────┼──────┬─────────┬─────────┐
    ▼      ▼      ▼         ▼         ▼
 OpenCode  VSCode  Cursor  JetBrains  WindSurf
    │      │       │         │         │
    └──────┴───────┴─────────┴─────────┘
                    │
             All synced from central source

3. Global Mode (Your Personal Library)

Sync from a global configuration (~/.agents/) to all projects:

# Sync from global config to project
ai-sync --global

4. Watch Mode (Real-time Sync)

Watch for file changes and auto-sync:

# Watch and sync automatically
ai-sync --from claude --to vscode --path ./project --watch

5. Dry Run (Preview)

Preview what will be synced without making changes:

# See what would happen
ai-sync --from claude --to vscode --path ./project --dry-run

MCP Server

The MCP server is included in the same package:

# Start the MCP server
npx ai-sync-mcp

# Configure in Claude Desktop
{
  "mcpServers": {
    "ai-sync": {
      "command": "npx",
      "args": ["ai-sync-mcp"]
    }
  }
}

Common Workflows

Token Limit Workflow

# 1. You're working with Claude, close to token limit
ai-sync --from claude --to vscode --path ./my-project

# 2. Open VS Code, continue from where Claude left off

Team Collaboration

# Use Copilot as central source (team standard)
ai-sync --central copilot

# Everyone syncs from Copilot's context

Personal Productivity

# Set up your personal skills once
mkdir -p ~/.agents/skills
# Add your custom prompts, commands, etc.

# Sync to any project
ai-sync --global

Command Options

| Flag | Short | Description | Default | |------|-------|-------------|---------| | --from | -f | Source agent | Required for direct sync | | --to | -t | Target IDE | Required for direct sync | | --path | -p | Project path | Current directory | | --central | | Agent ID as central source | Syncs to all detected | | --global | | Use global config | Syncs from ~/.agents/ | | --watch | -w | Watch mode | false | | --dry-run | | Preview only | false | | --overwrite | -o | Overwrite existing | false | | --profile | | Profile name | | | --json | -j | JSON output | false |

Other Commands

# Initialize config in project
ai-sync init
ai-sync init --tools claude,opencode,copilot

# Check configuration
ai-sync doctor
ai-sync doctor --json

# Clean synced files
ai-sync clean
ai-sync clean --dry-run

# Manage configuration
ai-sync config ls
ai-sync config show
ai-sync config add tool claude
ai-sync config rm tool opencode

# List supported tools
ai-sync list agents   # Show all agents
ai-sync list tools    # Show all IDEs

Features

• Sync Anywhere - Move between Claude, Copilot, Gemini, Cursor, WindSurf, and 20+ agents
• All IDEs - Export to VS Code, JetBrains, Zed, Vim, Emacs, and more
• Conversations Travel - Your session context follows you, not just files
• Real-time Watch - Auto-sync as you code
• Central Mode - Any agent can be the source for all others
• MCP Built-in - Full Model Context Protocol server for AI integration

Configuration

Create .agents/agentsync.toml in your project:

# Tools to sync
tools = ["claude", "opencode", "vscode"]

# MCP servers
[mcp.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]

# Profiles
[profiles.frontend]
tools = ["claude", "cursor"]

[profiles.backend]
tools = ["claude", "jetbrains"]

Supported Agents (--from or --central)

| Agent | ID | |-------|-----| | Claude Code | claude | | GitHub Copilot | copilot | | Google Gemini | gemini | | Cursor | cursor | | WindSurf | windsurf | | Aider | aider | | Continue | continue | | Amazon Q | amazonq | | Codex | codex | | Devin | devin | | Replit | replit | | Trae | trae | | CodePal | codepal | | Kiro | kiro | | OpenHands | openhands | | Junie | junie | | Crush | crush | | KiloCode | kilocode | | Qwen | qwen | | Amp | amp | | Goose | goose | | RooCode | roocode | | Cline | cline |

Supported IDEs (--to)

| IDE | Directory | |-----|----------| | OpenCode | .agents/ | | VS Code | .vscode/ | | JetBrains | .jetbrains/ | | Cursor | .cursor/ | | Zed | .zed/ | | Vim/Neovim | .vim/ | | Emacs | .emacs.d/ | | WindSurf | .windsurf/ | | Lapce | .lapce/ | | Nova | .nova/ | | Sublime | .sublime/ | | Atom | .atom/ | | Onivim | .onivim/ | | Tabby | .tabby/ |

Documentation

• Installation Guide - Detailed installation
• Usage Guide - All commands and options
• Practical Examples - Real-world workflows
• MCP Setup - IDE and agent integration
• API Reference - Programmatic usage

Requirements

• Node.js >= 20.0.0
• npm, yarn, or pnpm

License

MIT License - see LICENSE

Built by José Carrillo