CapSync

Stop copying your AI skills between tools. Do it once, use them everywhere.

What is CapSync?

You have a collection of AI coding skills. Maybe they are prompts, context files, or reusable instructions. You want to use these skills across multiple AI coding assistants: OpenCode, Claude Code, Cursor, Codex, and dozens of others.

The problem? Each tool stores skills in a different location:

Tool	Skills Location
OpenCode	~/.config/opencode/skill/
Claude Code	~/.claude/skills/
Cursor	~/.cursor/skills/
Codex	~/.codex/skills/
Amp	~/.agents/skills/
Antigravity	~/.agent/skills/

And that is just six tools. CapSync supports over 40.

CapSync solves this by creating a single source of truth for your skills. You maintain one skills directory. CapSync creates symlinks from that directory to each tool's expected location. Add a skill once, it appears in every tool. Remove it once, it disappears everywhere.

Important Notice

What CapSync Is:

• A synchronization tool that links your existing skills to multiple AI coding assistants
• A symlink manager that keeps one skills directory in sync with many tools

What CapSync Is Not:

• A skill discovery tool. CapSync does not find or download skills from the internet
• A skill installer. You must already have skills in your source directory
• A skill creator. CapSync only syncs what you already have

Prerequisites: You need to have skills already installed in a local directory before using CapSync. CapSync assumes you have:

• A directory containing your skills (e.g., ~/Dev/scripts/skills/skills)
• Skills formatted for your AI tools (typically directories with SKILL.md files)

If you are looking for a tool to discover and install skills from a registry or repository, that is not what CapSync does. That may be a future feature, but for now, CapSync only syncs skills you already possess.

Installation

Download Pre-built Binary

macOS (Apple Silicon):

curl -L -o capsync https://github.com/pixincreate/cap_sync/releases/latest/download/capsync-darwin-aarch64
chmod +x capsync
./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 (x86_64):

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

Optional: Add to PATH

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

Install via Cargo

cargo install capsync

Build from Source

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

Getting Started

Initial Setup

Run capsync init to create your configuration. The tool will:

1. Ask for your skills directory path (supports $HOME, ~, and other shell variables)
2. Scan your system for installed AI coding tools
3. Add only the detected tools to your configuration
4. Enable those tools automatically

$ capsync init
Welcome to CapSync! Let's set up your configuration.

Enter your skills directory: $HOME/Dev/scripts/skills/skills

Detecting installed tools...
Detected and enabled: claude, opencode

Configuration created at /Users/you/.config/capsync/config.toml

Daily Workflow

After initial setup, your workflow is simple:

# Sync your skills to all enabled tools
capsync sync

# Check the status of your symlinks
capsync status

# View your current configuration
capsync config

Adding New Tools

When you install a new AI coding tool, add it to CapSync:

# Add the tool and sync automatically
capsync add cursor

# Or add without syncing
capsync add codex --no-sync

CapSync validates the tool name against its supported tools list. If you try to add an unsupported tool:

$ capsync add unknown-tool
Error: Tool 'unknown-tool' does not exist or is unsupported in the current version

Removing Tools

Remove a specific tool's symlink:

capsync remove claude

Remove all symlinks:

capsync remove --all

How It Works

CapSync uses directory symlinks (symbolic links) to connect your skills to each tool.

The Setup

1. You designate one directory as your skills source (e.g., ~/Dev/scripts/skills/skills)
2. CapSync creates symlinks from that directory to each tool's expected skills location
3. Each tool sees your skills as if they were native to that tool

The Benefits

• Single source of truth: Edit skills in one place
• Automatic propagation: Changes appear in all tools immediately
• No copying: Symlinks are lightweight pointers, not copies
• Easy management: Add or remove tools without reorganizing files
• Clean removal: Remove a tool's access without deleting your skills

Example

Before CapSync:

~/Dev/scripts/skills/
  ├── my-skill/
  │   └── SKILL.md

~/.config/opencode/skill/
  └── my-skill/          (copy)
      └── SKILL.md       (copy)

~/.claude/skills/
  └── my-skill/          (copy)
      └── SKILL.md       (copy)

After CapSync:

~/Dev/scripts/skills/
  └── my-skill/
      └── SKILL.md       (original)

~/.config/opencode/skill/
  └── my-skill -> ~/Dev/scripts/skills/my-skill  (symlink)

~/.claude/skills/
  └── my-skill -> ~/Dev/scripts/skills/my-skill  (symlink)

Configuration File

CapSync stores its configuration at ~/.config/capsync/config.toml:

source = "/Users/you/Dev/scripts/skills"

[destinations.opencode]
enabled = true
path = "/Users/you/.config/opencode/skill"

[destinations.claude]
enabled = true
path = "/Users/you/.claude/skills"

[destinations.cursor]
enabled = false
path = "/Users/you/.cursor/skills"

You can manually edit this file to:

• Change the source directory
• Enable or disable specific tools
• Adjust destination paths if your tools use non-standard locations

Supported Tools

CapSync currently supports 40+ AI coding assistants:

A-C: AdaL, Amp, Antigravity, Claude Code, Cline, CodeBuddy, Codex, Command Code, Continue, Crush, Cursor

D-G: Droid, Gemini CLI, GitHub Copilot, Goose

J-K: Junie, Kilo Code, Kimi CLI, Kiro CLI, Kode

M-N: MCPJam, Moltbot, Mux, Neovate

O-Q: OpenCode, OpenHands, OpenClaude IDE, Pi, Pochi, Qoder, Qwen Code

R-Z: Replit, Roo Code, Trae, Trae CN, Windsurf, Zencoder

Missing a tool? CapSync is designed to easily add new tools. Open an issue or submit a PR.

Command Reference

capsync init

Initialize configuration. Detects installed tools and creates config file.

capsync config

Display current configuration and enabled tools.

capsync detect-tools

Scan system for installed AI coding tools without modifying config.

capsync sync

Create or update symlinks for all enabled tools.

capsync add <tool>

Add a tool to configuration and sync automatically.

Options:

• --no-sync: Add tool without running sync

capsync remove <tool>

Remove symlink for a specific tool.

Options:

• --all: Remove all symlinks

capsync status

Check status of source directory and all symlinks.

Skill Format

While CapSync does not enforce a specific skill format, most AI tools expect:

your-skill/
└── SKILL.md

The SKILL.md typically includes metadata and instructions:

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

# Your Skill

Detailed instructions for the AI...

CapSync syncs the entire directory structure, so your skills can include multiple files, subdirectories, or any format your tools support.

Development

Build the project:

cargo build

Run tests:

cargo test

Run locally:

cargo run -- init

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

This project is dedicated to the public domain under the CC0 1.0 Universal License.