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