agentsync

# agentsync

**Sync MCP server configs and rules across AI coding agents.**

[![CI](https://github.com/spyrae/agentsync/actions/workflows/ci.yml/badge.svg)](https://github.com/spyrae/agentsync/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/agentsync-cli)](https://pypi.org/project/agentsync-cli/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)

---

## The Problem

You use multiple AI coding agents — Claude Code, Cursor, Codex, Cursor. Each stores MCP server configs in its own format (JSON, TOML) and its own location. Keeping them in sync manually is tedious and error-prone.

## The Solution

**agentsync** takes a single source of truth (your Claude Code config) and syncs it to all your agents with one command.

```
┌──────────────┐
│  Claude Code │  Source of Truth
│  .cursor.json│  ─── MCP Servers
│  .mcp.json   │  ─── Rules (CLAUDE.md)
│  CLAUDE.md   │
└──────┬───────┘
       │  agentsync sync
       ├──────────────────┐─────────────────┐
       ▼                  ▼                 ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│    Cursor    │  │    Codex     │  │  Antigravity │
│  mcp.json   │  │ config.toml  │  │mcp_config.json│
│ project.mdc │  │  AGENTS.md   │  │              │
└──────────────┘  └──────────────┘  └──────────────┘
```

## Installation

```bash
pip install agentsync-cli     # pip
pipx install agentsync-cli    # pipx (recommended for CLI tools)
uvx agentsync-cli             # uv (run without installing)
```

## Quick Start

```bash
agentsync init       # Create agentsync.yaml config
agentsync sync       # Sync to all agents
agentsync validate   # Verify everything is correct
```

## Features

- **MCP server sync** — JSON ↔ TOML automatic conversion
- **Rules sync** — Markdown → filtered Markdown / MDC with frontmatter
- **Case-insensitive deduplication** — han