mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
The backup docs claimed per-skill symlinks were "resolved and followed" and their real content backed up, which is now the opposite of what happens. Adds a Backups & Disk Space section contrasting the three mechanisms that are easy to conflate — .gitignore (git only), ignore: (sync), and backup (local target content) — plus an ENOSPC troubleshooting entry, since disk space had no coverage anywhere in troubleshooting despite being how this surfaced. Also corrects two long-standing errors: the backup location was documented under ~/.config in the built-in skill reference and in a `backup --list` example, but backups live in the XDG data dir (config.DataDir()); and the built-in skill claimed backup was global-mode only, when project mode does support agent backups. Refs #252
166 lines
4.8 KiB
Markdown
166 lines
4.8 KiB
Markdown
---
|
|
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 <timestamp>` | 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 `<target>-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
|