Skip to content
Development
Command

/restore

Restore a handoff snapshot from `.claude/handoff/history/` as the current handoff. Usage - /handoff-revive:restore <timestamp>

From plugin
claude-handoff-revive
611 skills11 commands
Install
$ npx -y skills add sofumel/claude-handoff-revive --agent claude-code

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/restore

Context preview

What this command does when you run it.

Restore a handoff snapshot from `.claude/handoff/history/` as the current handoff. Usage - /handoff-revive:restore <timestamp>

Command definition

restore.md
description: Restore a handoff snapshot from `.claude/handoff/history/` as the current handoff. Usage - /handoff-revive:restore <timestamp>
argument-hint: <timestamp>

Restore the snapshot the user named (`$ARGUMENTS`). If no timestamp was given, run `/handoff-revive:list` behavior first (list-history script) and ask which one to restore.

  • Linux/macOS/WSL/Git-Bash:
  bash "${CLAUDE_PLUGIN_ROOT:-.claude}/skills/handoff-revive/scripts/restore-history.sh" <timestamp>
  • Windows PowerShell:
  $r = if ($env:CLAUDE_PLUGIN_ROOT) { $env:CLAUDE_PLUGIN_ROOT } else { ".claude" }; powershell -ExecutionPolicy Bypass -File "$r/skills/handoff-revive/scripts/restore-history.ps1" -Timestamp <timestamp>

The script archives the existing `current.md` into history before overwriting, so nothing is lost. On success, confirm in the user's language and offer to run `/handoff-revive:resume` to continue from the restored snapshot.

Note: this restores the **structured handoff snapshot** (goal / done / wip / todo / next_action / touched_files / decisions / lessons_learned) — not the full conversation. Rolling back conversation history is what native `--resume` / `/rewind` do; this restores the much cheaper work-state checkpoint instead.

Ships withclaude-handoff-revive

Resume Claude Code work after rate/usage/context limits without replaying the prior transcript. Auto-saves at 90%/95% usage. Plugin-installable, 10 languages.

Get the whole plugin, auto-invoked
Stats
6
Stars
0
Views
1
Forks
Maintained
Maintenance
PowerShell
Language
MIT
License
1mo ago
Last commit
3mo ago
Created

Repo: sofumel/claude-handoff-revive