Files
skillshare/website/docs/commands/pull.md
T
2026-02-01 22:52:11 +08:00

115 lines
4.1 KiB
Markdown

---
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