--- sidebar_position: 2 --- # pull Pull from git remote and sync to all targets. ```bash skillshare pull # Pull and sync skillshare pull --dry-run # Preview ``` ## What Happens ``` ┌─────────────────────────────────────────────────────────────────┐ │ skillshare pull │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 1. Check repository status │ │ → Source is a git repo: ✓ │ │ → Remote configured: ✓ │ │ → No local changes: ✓ │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 2. Pull from remote │ │ → git pull │ │ → ✓ Pull complete │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 3. Sync to all targets (automatic) │ │ → skillshare sync │ │ → ✓ claude: merged (5 linked) │ │ → ✓ cursor: merged (5 linked) │ └─────────────────────────────────────────────────────────────────┘ ``` ## Options | Flag | Description | |------|-------------| | `--dry-run, -n` | Preview without making changes | ## Prerequisites Your source directory must be a git repository with a remote: ```bash # Check if ready: skillshare status # Shows: Git: initialized with remote ``` ## Local Changes Warning If you have uncommitted changes, `pull` will fail: ```bash $ skillshare pull Local changes detected Run: skillshare push Or: cd ~/.config/skillshare/skills && git stash ``` Solutions: ```bash # Option 1: Push your changes first skillshare push skillshare pull # Option 2: Stash your changes cd ~/.config/skillshare/skills git stash skillshare pull git stash pop ``` ## Examples ```bash # Standard pull (most common) skillshare pull # Preview what would happen skillshare pull --dry-run ``` ## Workflow Typical workflow on a secondary machine: ```bash # Start of day: get latest skills skillshare pull # ... work with AI tools ... # End of day: share any new skills skillshare collect claude # If you created new skills skillshare push -m "Add new skill" ``` ## Related - [push](/docs/commands/push) — Push to remote - [sync](/docs/commands/sync) — Manual sync without pull - [Cross-Machine Sync](/docs/guides/cross-machine-sync) — Full setup