--- sidebar_position: 3 --- # restore Restore a target from a backup. ```bash skillshare restore # Interactive TUI (browse + restore) skillshare restore claude # Latest backup skillshare restore claude --from 2026-01-19_10-00-00 # Specific backup skillshare restore claude --dry-run # Preview ``` ## When to Use - A sync went wrong and you need to revert a target to its previous state - You accidentally removed skills from a target - Browse backup versions interactively and compare against current state ## Interactive TUI On a TTY, `skillshare restore` (with no arguments) launches a unified restore TUI: 1. **Source picker** — Choose between "Backup Restore" and "Trash Restore" 2. **Backup Restore** — Select a target, then browse backup versions with a detail panel showing: - Backup date, size, and skill count - Diff vs current target (added/removed skills) - Individual file listings 3. **Trash Restore** — Opens the trash TUI to restore deleted skills ### Key Bindings | Key | Action | |-----|--------| | `↑`/`↓` | Navigate targets / versions | | `Enter` | Select target / restore version | | `/` | Filter targets | | `d` | Delete a backup version | | `Ctrl+d`/`Ctrl+u` | Scroll detail panel | | `Esc` | Go back | | `q`/`Ctrl+C` | Quit | Use `--no-tui` to skip the TUI and show a plain backup list instead. ## What Happens ```mermaid flowchart TD CMD["skillshare restore claude"] FIND["1. Find latest backup"] REMOVE["2. Remove current target"] COPY["3. Copy backup to target"] CMD --> FIND --> REMOVE --> COPY ``` ## Options | Flag | Description | |------|-------------| | `--all` | Restore both skills and agents | | `--project, -p` | Use project mode (`.skillshare/backups/`); **agents only** | | `--global, -g` | Use global mode (default for skills) | | `--from, -f ` | Restore from specific backup | | `--force` | Overwrite without confirmation | | `--dry-run, -n` | Preview without making changes | | `--no-tui` | Skip interactive TUI, show backup list instead | `restore` also accepts a positional kind argument: `skillshare restore agents claude` restores the agent backup for the `claude` target. ## Finding Backups List available backups: ```bash skillshare backup --list ``` ``` All backups (15.3 MB total) 2026-01-20_15-30-00 claude, cursor 4.2 MB 2026-01-19_10-00-00 claude 2.1 MB 2026-01-18_09-00-00 claude, cursor 4.0 MB ``` ## Examples ```bash # Restore from latest backup skillshare restore claude # Restore from specific backup skillshare restore claude --from 2026-01-19_10-00-00 # Preview restore skillshare restore claude --dry-run # Force restore (skip confirmation) skillshare restore claude --force ``` ## After Restoring `restore` replaces the target directory with the snapshot's contents. Because backups capture only local content — symlinked skills are excluded, see [What Gets Backed Up](/docs/reference/commands/backup#what-gets-backed-up) — run `sync` afterwards to bring synced skills back: ```bash skillshare restore claude # Restore local content from backup skillshare sync # Recreate symlinks for synced skills ``` Restored content is regular files, not symlinks. If the target only ever held local skills, the restore alone is enough. ## Use Cases ### Accidental Deletion If you accidentally deleted a skill: ```bash skillshare restore claude --from 2026-01-19_10-00-00 ``` ### Reverting Changes If a sync went wrong: ```bash skillshare restore claude # Go back to pre-sync state ``` ### Testing Restore to test old skill versions: ```bash skillshare restore claude --from 2026-01-15_10-00-00 # Test old skills... skillshare sync # Return to current state ``` ### Agent Restore Agent restore mirrors skill restore but operates on the parallel `-agents` backup entries created by `backup agents` (and the auto-backup that runs before `sync agents`): ```bash skillshare restore agents claude # Latest agent backup for claude skillshare restore agents claude --from 2026-01-19_10-00-00 skillshare restore agents -p # Project agents (the only project mode allowed) skillshare restore --all claude # Skills + agents in one shot ``` In project mode, restore — like backup — only operates on agents. Without the `agents` argument it errors: ``` restore is not supported in project mode (except for agents) ``` When listing backups via `skillshare backup --list`, agent backups show as separate entries with the `-agents` suffix (e.g. `claude-agents`). ## See Also - [backup](/docs/reference/commands/backup) — Create and manage backups - [sync](/docs/reference/commands/sync) — Re-sync after restore - [Agents](/docs/understand/agents) — Agent resource model