sync-setup
Use when the user wants to set up config sync for the first time, connect to GitHub, or re-initialize the backup repo.
Allowed Tools
Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/*")Bash(gh *)Bash(git *)ReadWrite
Provided by Plugin
claudebase
Back up and restore your entire Claude Code environment to a private GitHub repo
Installation
This skill is included in the claudebase plugin:
/plugin install claudebase@claude-code-plugins-plusClick to copy
Instructions
Config Sync Setup
Initialize Claude Config Sync by connecting to GitHub and creating the backup repository.
What this does
- Verifies
ghCLI is installed and authenticated - Creates a private GitHub repo for config storage (or connects to existing)
- Initializes the repo structure with a default profile
- 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 REPONAME and PROFILENAME 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 ghorsudo 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