Why agentsync?

🎯

Single Source of Truth

Maintain one AGENTS.md and sync it to Claude, Copilot, Gemini, and more via symlinks.

🔗

Instant Propagation

Uses symbolic links instead of copies. Change a file once, and every assistant sees it immediately.

🤖

MCP Integration

Define MCP servers once in TOML and sync them across all supported agent environments.

🧰

Skills

Install and manage reusable skills (from skills.sh or local archives) under .agents/skills/.

📁

Gitignore Management

Automatically manages your .gitignore to keep symlinks out of your repository.

⚙️

Cross-Platform

Written in Rust for maximum speed and portability. Works on macOS, Linux, and Windows.

💻

Developer First

Clean CLI, human-readable TOML configuration, and CI-friendly execution.

---

Quick Start

# Install (macOS)
# Detect architecture and download
PLATFORM=$([ "$(uname -m)" = "arm64" ] && echo "aarch64-apple-darwin" || echo "x86_64-apple-darwin")
curl -LO "https://github.com/dallay/agentsync/releases/latest/download/agentsync-${PLATFORM}.tar.gz"
tar xzf "agentsync-${PLATFORM}.tar.gz"
sudo mv agentsync-*/agentsync /usr/local/bin/

# Initialize and apply
agentsync init
agentsync apply

This documentation is the authoritative project reference.

Canonical Source: All agent instructions and skills are maintained in .agents/AGENTS.md. This is the single source of truth—they get synced everywhere!