✨ Why vsync?
The Problem: You love using multiple AI vibe coding tools (Claude Code, Cursor, OpenCode, Codex...), but each tool has:
- Different directory structures for Skills, Agents, Commands, MCP servers
- Different config file formats (JSON, TOML, JSONC)
- Different environment variable syntax
Managing configurations across tools becomes a nightmare, especially for teams.
The Solution: vsync gives you one command to sync everything. Pick one tool as your source of truth, and all others stay perfectly in sync.
The Problem We Solve
| 😫 Without vsync | 🎉 With vsync |
|---|
| 📋 Manually copy configs between multiple vibe coding tools | ⚡ One command syncs everything automatically |
| 📂 Different directories for Skills/Agents/Commands/MCP in each tool | 🎯 One command maps to all correct paths |
| 🔥 Environment variables break during migration | 🛡️ Variables preserved safely (JSON ↔ TOML ↔ JSONC) |
| 🤷 No idea which configs are outdated or in conflict | 📊 Smart diff shows exactly what changed and why |
| ⚠️ Risky deletions, manual cleanup nightmares | ✅ Safe mode by default, Prune mode for strict mirroring |
| 🔧 Multiple tools = multiple config formats | 🎯 Transparent format conversion (preserves JSONC comments!) |
| 🐌 Copying dozens of configs manually is painfully slow | ⚡ Instant sync with parallel operations & smart caching |
Key Benefits
📚 Single Source of Truth → All tools sync from one place
🎯 Smart Diff Planning → Preview changes before applying
⚡ Safe & Prune Modes → Choose your sync strategy
🌈 Multi-Tool Support → Claude Code, Cursor, OpenCode, Codex
🗣️ Multi-Language CLI → English & 中文 (Chinese)
⚡ Performance Optimized → Parallel ops, caching, symlinks
🔗 Symlink Support → Share Skills via symlinks (optional)
How It Works
flowchart TD
A[Pick Source Tool<br/>Your source of truth] --> B[vsync reads configs<br/>Skills, MCP, Agents, Commands]
B --> C[Compare with targets<br/>Calculate differences]
C --> D[Show you the plan<br/>What will change]
D --> E{Your approval}
E -->|Yes| F[Auto-convert formats<br/>JSON → TOML → JSONC]
E -->|No| G[Cancelled]
F --> H[Write to all targets<br/>Crash-safe atomic writes]
H --> I[✅ All tools synced!]
style A fill:#e1f5ff
style I fill:#c8e6c9
style E fill:#fff9c4
The magic: Edit configs in ONE tool → Run vsync sync → ALL tools stay in sync
🎯 Features
