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.
Best for Claude Code usersWorks with GitHubLow risk
⌘source
- author
@jeremylongshore- language
- Python
★2.1kstars
281forks
May 1, 2026
✦overview.md
Key Features
- ·Verifies gh CLI installation and auth
- ·Creates private GitHub backup repo
- ·Initializes repo with default profile
- ·First push of current Claude Code config
Use Cases
- →Setting up config sync for the first time
- →Connecting Claude Code to a new GitHub account
- →Re-initializing config backup after repository issues
Best for
- ✓Claude Code users
- ✓config backup setup
Not ideal for
- !non-GitHub workflows
FAQs
name
sync-setup
description
Use when the user wants to set up config sync for the first time, connect to GitHub, or re-initialize the backup repo.
license
MIT
argument-hint:[repo-name] [profile-name]
user-invocable:true
allowed-tools:Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/*"), Bash(gh *), Bash(git *), Read, Write
version:0.2.0
author:Rohit Hazra
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 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 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
$install
1-click copynpx skills add jeremylongshore/claude-code-plugins-plus-skills --skill sync-setupSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.