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

flowchart LR
    A[Claude Code] -->|ai-sync| B[VS Code]
    B -->|Continue| C[Full Context]
    A -->|ai-sync| D[Cursor]
    A -->|ai-sync| E[JetBrains]
    A -->|ai-sync| F[WindSurf]

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

Usage Examples

Basic Sync

# Claude → VS Code (flags work directly, no sync subcommand)
ai-sync --from claude --to vscode --path ./my-app

# Short flags
ai-sync -f claude -t vscode -p ./my-app

# Preview what will sync (dry run)
ai-sync --dry-run

Real-time Watch Mode

# Watch for changes and auto-sync
ai-sync --from claude --to opencode --path ./project --watch

Central Mode (One Source, All Targets)

flowchart TB
    C[Claude<br/>Central] -->|sync to all| O[OpenCode]
    C -->|sync to all| V[VS Code]
    C -->|sync to all| Cu[Cursor]
    C -->|sync to all| J[JetBrains]
    C -->|sync to all| W[WindSurf]

# Use Claude as central source, sync to ALL detected tools
ai-sync --central claude

Global Mode (Your Personal Library)

# Sync from your global skills/commands library
ai-sync --global

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"]
    }
  }
}

List Available Tools

# Show all supported agents
ai-sync list agents

# Show all supported IDEs
ai-sync list tools

Diagnostics

# Check configuration and connectivity
ai-sync doctor

# JSON output for automation
ai-sync doctor --json

Workflow Example

sequenceDiagram
    participant U as User
    participant CC as Claude Code
    participant AS as AI Sync
    participant VS as VS Code

    Note over U,CC: User working with Claude Code
    CC->>U: Hits token limit
    U->>AS: ai-sync --from claude --to vscode
    AS->>VS: Syncs conversation & context
    Note over VS: Full history available
    VS->>U: Continue where Claude left off

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 - One agent as source, all others sync automatically
• 🔌 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"]

MCP Tools

Architecture Overview

flowchart TB
    subgraph CLI
        C[ai-sync CLI]
    end

    subgraph MCP
        M[ai-sync-mcp<br/>Server]
    end

    subgraph Agents
        CC[Claude Code]
        CO[Copilot]
        GE[Gemini]
    end

    subgraph IDEs
        VS[VS Code]
        JT[JetBrains]
        CD[Cursor]
    end

    C -->|sync| Agents
    M -->|MCP protocol| IDEs
    Agents -->|read/write| IDEs

Supported Agents

Supported IDEs

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