CapSync

A simple tool to sync your AI coding skills across different tools.

The Problem

Different AI coding tools store skills in different folders:

Managing the same skills in all these places is annoying.

The Solution

Keep your skills in one place and let CapSync sync them everywhere.

Installation

Option 1: Download Binary (Quickest)

Download a pre-built binary and use it directly:

macOS (Apple Silicon):

curl -L -o capsync https://github.com/pixincreate/cap_sync/releases/latest/download/capsync-darwin-aarch64
chmod +x capsync
# Move to a directory in your PATH, or use directly:
./capsync init

macOS (Intel):

curl -L -o capsync https://github.com/pixincreate/cap_sync/releases/latest/download/capsync-darwin-x86_64
chmod +x capsync
./capsync init

Linux:

curl -L -o capsync https://github.com/pixincreate/cap_sync/releases/latest/download/capsync-linux-x86_64
chmod +x capsync
./capsync init

Add to your shell (optional):

# Add to ~/.zshrc or ~/.bashrc
export PATH="$PATH:/path/to/capsync/dir"

Option 2: Install via cargo

If you have Rust installed:

cargo install capsync

Option 3: Build from Source

git clone https://github.com/pixincreate/cap_sync.git
cd cap_sync
cargo install --path .

Quick Start

# Set up config
capsync init

# See which tools you have
capsync detect-tools

# Sync your skills
capsync sync

# Check what's synced
capsync status

# Remove from a specific tool
capsync remove claude

# Remove from all tools
capsync remove --all

Commands

capsync init

Creates the config file with sensible defaults at ~/.config/capsync/config.toml.

capsync config

Shows your current settings.

capsync detect-tools

Checks which AI coding tools are installed on your system.

capsync sync

Creates symlinks from your source directory to all enabled tool destinations.

capsync status

Shows the current sync status:

• Whether source directory exists
• Which destinations have symlinks
• Whether symlinks are valid or broken

capsync remove <tool>

Removes the symlink from a specific tool's directory.

Example: capsync remove codex

capsync remove --all

Removes symlinks from all destinations.

Configuration

Config file is at ~/.config/capsync/config.toml:

source = "~/Dev/scripts/skills/skills"

[destinations]
opencode = { enabled = true, path = "~/.config/opencode/skill" }
claude = { enabled = true, path = "~/.claude/skills" }
codex = { enabled = false, path = "~/.codex/skills" }
cursor = { enabled = false, path = "~/.cursor/skills" }
amp = { enabled = false, path = "~/.agents/skills" }
antigravity = { enabled = false, path = "~/.agent/skills" }

Change:

• source: Where your skills are stored
• enabled: Turn tools on/off
• path: Where each tool keeps its skills

How It Works

1. You put skills in one folder
2. CapSync creates a directory symlink from that folder to each tool's skills folder
3. Any files you add/remove in the source are automatically available in all destinations
4. No need to re-run sync when you add new skills

Skill Format

Each skill is a folder with a SKILL.md file:

my-skill/
└── SKILL.md

The SKILL.md needs this header:

---
name: my-skill
description: What this skill does
license: MIT
---

# My Skill

Details about your skill...

Supported Tools

• OpenCode
• ClaudeCode
• Cursor
• Codex
• Amp
• Antigravity

Development

# Build
cargo build

# Test
cargo test

# Run locally
cargo run -- sync

Contributing

1. Fork the repo
2. Make changes
3. Test your changes
4. Send a pull request

License

CC0 1.0 Universal