Files
skillshare/website/docs/reference/commands/restore.md
T
Willie 806045d392 docs(agents): expand docs + skillshare SKILL.md for agent workflows
- skills/skillshare/SKILL.md: mention agents commands/flags in description
- website: document agents source dir, agent backup/restore, ignores,
  file structure, config fields, and project-mode agent rules
2026-04-11 00:41:29 +08:00

4.6 KiB

sidebar_position
sidebar_position
3

restore

Restore a target from a backup.

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

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:

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

# 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

After restore, your target will have regular directories instead of symlinks. To re-sync:

skillshare restore claude    # Restore backup
skillshare sync              # Re-sync from source (creates symlinks)

Or keep the restored state:

skillshare restore claude    # Restore backup
# Done - skills are now local copies

Use Cases

Accidental Deletion

If you accidentally deleted a skill:

skillshare restore claude --from 2026-01-19_10-00-00

Reverting Changes

If a sync went wrong:

skillshare restore claude  # Go back to pre-sync state

Testing

Restore to test old skill versions:

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

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 — Create and manage backups
  • sync — Re-sync after restore
  • Agents — Agent resource model