restore-snapshot — Claude Code command: resume a session
The restore-snapshot command uses .claude/snapshot.md to recap prior work and ask what to tackle next. Run it when you want to carry context into a new session.
MIT ★ 233 updated 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringWhat restore-snapshot does
The command reads .claude/snapshot.md as a handoff for the current session. It gives a short recap, then asks which item in “Next” to focus on. A snapshot older than 24 hours triggers a warning first. The file is deleted after it has been read, so keep anything you still need elsewhere.
When the file is missing, the command offers to check git log, claude-mem, and open beads. Model invocation is disabled, so you have to start the command yourself. Install the plugin and add its command file at .claude/commands/restore-snapshot.md.
What it helps with
- resume work from a previous session
- recap where a task was left
- choose a follow-up item from “Next”
- check Git history when no snapshot exists
Example prompts for the agent
- Read
.claude/snapshot.md, recap the last session, and ask what I should work on next. - Use the session snapshot to pick up where we left off.
- If the snapshot is missing, offer to check
git log,claude-mem, and open beads.
How to install restore-snapshot
1Plugin marketplace
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineering2Manually: put the files in place
.claude/commands/restore-snapshot.mdCall it with /restore-snapshot. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/restore-snapshot.mdCall it with /prompts:restore-snapshot. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/restore-snapshot.prompt.mdManually: put the files in place
.gemini/commands/restore-snapshot.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about restore-snapshot
How do I install restore-snapshot in Claude Code?
Run /plugin marketplace add johnrogers/claude-swift-engineering, then /plugin install swift-engineering@claude-swift-engineering. The command file path is .claude/commands/restore-snapshot.md.
What does restore-snapshot do?
It reads .claude/snapshot.md, recaps the previous work, and asks which item in “Next” to pursue. It deletes the snapshot after reading it.
What happens if the snapshot is missing or older than 24 hours?
For a snapshot older than 24 hours, the command warns you before proceeding. If the file is missing, it offers to check git log, claude-mem, and open beads.
Source text
restore-snapshot.md · MIT
description: Resume work from a previous session snapshot. Reads the snapshot file and then deletes it when done. disable-model-invocation: true --- Read `.claude/snapshot.md` and use it to orient this session. 1. Read the handoff file 2. If older than 24 hours, warn the user before proceeding 3. Briefly summarize where we left off 4. Delete the handoff file 5. Ask the user what they want to focus on from the "Next" items If no handoff file exists, say so and offer to check git log, claude-mem, and open beads instead.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering