Sync Setup

Config Sync Setup

Initialize Claude Config Sync by connecting to GitHub and creating the backup repository.

What this does

1. Verifies gh CLI is installed and authenticated
2. Creates a private GitHub repo for config storage (or connects to existing)
3. Initializes the repo structure with a default profile
4. Performs the first push of your current Claude Code config

Instructions

Run the setup script. Parse user arguments for custom repo name and profile:

• First argument (if provided): repo name (default: claude-config)
• Second argument (if provided): initial profile name (default: default)

bash "${CLAUDE_PLUGIN_ROOT}/scripts/ensure-repo.sh" REPO_NAME PROFILE_NAME

Replace REPO_NAME and PROFILE_NAME with the user's values or defaults.

If gh is not installed

Guide the user to install it:

• macOS: brew install gh
• Linux: sudo apt install gh or sudo dnf install gh
• Windows: winget install --id GitHub.cli

Then authenticate: gh auth login

After setup succeeds

Run the first push automatically:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/sync-push.sh" --profile PROFILE_NAME

Tell the user what was synced and show all available commands: /sync-push, /sync-pull, /sync-status, /sync-profiles, /sync-config.

User Arguments

$ARGUMENTS