nicepkg-vsync

---

✨ 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