sync-pull
Use when the user wants to restore, download, or pull their Claude Code config from GitHub onto this machine.
Best for Claude Code power usersWorks with GitHubLow risk
⌘source
- author
@jeremylongshore- language
- Python
★2.1kstars
281forks
May 1, 2026
✦overview.md
Key Features
- ·Pull config from GitHub backup repo
- ·Automatic backup with timestamp (keeps last 10)
- ·Layered profile application (shared → profile → global)
- ·Dry-run mode for preview
- ·JSON config validation
- ·Global settings opt-in
Use Cases
- →Setting up Claude Code on a new machine from your GitHub config backup
- →Restoring a specific profile configuration after changes or corruption
- →Syncing latest shared settings across multiple developer machines
- →Previewing config changes before applying with --dry-run
Best for
- ✓Claude Code power users
- ✓Multi-machine setups
- ✓Config backup management
Not ideal for
- !Non-GitHub config storage
- !One-time single machine use
FAQs
name
sync-pull
description
Use when the user wants to restore, download, or pull their Claude Code config from GitHub onto this machine.
license
MIT
argument-hint:[--profile NAME] [--dry-run] [--no-backup] [--yes] [--include-global]
user-invocable:true
allowed-tools:Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/*"), Bash(gh *), Bash(git *), Read
version:0.2.0
author:Rohit Hazra
Config Sync Pull
Pull configuration from your GitHub backup repo and apply it to the local machine.
What happens
- Backup — Current local config is backed up to plugin data directory (timestamped, keeps last 10)
- Apply shared — Files from
shared/directory are applied first (base layer) - Apply profile — Profile-specific files overlay on top (overrides shared where both exist)
- Apply global — User-level settings from
global/are applied to~/.claude/ - Verify — JSON config files are validated for correct syntax
Instructions
Parse user arguments and run the pull script:
bash "${CLAUDE_PLUGIN_ROOT}/scripts/sync-pull.sh" [OPTIONS]
Options:
--profile NAME— Pull a specific profile (default: active profile)--dry-run— Show what would be applied without writing any files--no-backup— Skip backup step (use with caution)--yes/-y— Skip confirmation prompt (auto-approve)--include-global— Also pull~/.claude/settings.json(global settings are opt-in)
Profile switching
$install
1-click copynpx skills add jeremylongshore/claude-code-plugins-plus-skills --skill sync-pullSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
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.