Quick Reference

# Project-level setup
vsync init
vsync sync
 
# User-level setup
vsync init --user
vsync sync --user

# 1. Edit configs in source tool
vim ~/.claude/skills/my-skill/SKILL.md
 
# 2. Sync to targets
vsync sync

# Check what will change
vsync plan
 
# Or use dry-run
vsync sync --dry-run
 
# If satisfied, apply
vsync sync

# Safe: Remove from targets only
vsync clean skill/old-skill
 
# Strict mirroring (deletes extras)
vsync sync --prune

vsync sync

vsync sync --prune

# Default behavior
vsync init       # Creates .vsync.json
vsync sync       # Syncs project configs

# Add --user flag
vsync init --user    # Creates ~/.vsync.json
vsync sync --user    # Syncs global configs

# Project config
vsync init
 
# User config
vsync init --user

# Safe sync
vsync sync
 
# Prune mode
vsync sync --prune
 
# Dry run
vsync sync --dry-run
 
# User-level
vsync sync --user
 
# Skip confirmation
vsync sync -y

# Preview changes
vsync plan
 
# User-level plan
vsync plan --user

# Check sync status
vsync status
 
# User-level status
vsync status --user

# List all
vsync list
 
# List skills
vsync list skills
 
# List MCP servers
vsync list mcp
 
# User-level
vsync list --user

# Remove single item from targets
vsync clean skill/old-skill
 
# Interactive selection
vsync clean
 
# Delete from source too (DANGEROUS!)
vsync clean skill/old-skill --from-source
 
# User-level
vsync clean --user
 
# Skip confirmation
vsync clean skill/old-skill -y

# Import from another project
vsync import ../other-project
 
# Import to user-level
vsync import ../other-project --user

{
  "version": "1.0.0",
  "level": "project",
  "source_tool": "claude-code",
  "target_tools": ["cursor", "opencode", "codex"],
  "sync_config": {
    "skills": true,
    "mcp": true
  },
  "use_symlinks_for_skills": false,
  "language": "en"
}

# 1. Commit config to git
git add .vsync.json
git commit -m "feat: add vsync config"
 
# 2. Team members clone and sync
git clone <repo>
cd <repo>
vsync sync

# GitHub Actions
- name: Sync configs
  run: npx @nicepkg/vsync sync --yes

# 1. Import from old project
vsync import ../old-project
 
# 2. Review plan
vsync plan
 
# 3. Sync to targets
vsync sync

# General help
vsync --help
 
# Command help
vsync sync --help
 
# Version
vsync --version

# Check directory permissions
ls -la ~/.cursor/
 
# On Windows: Run as Administrator for symlinks

# Solution: Initialize first
vsync init

# Solution: Create tool directory
mkdir -p ~/.cursor
vsync init