Skip to main content
command CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What 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-engineering

2Manually: put the files in place

.claude/commands/restore-snapshot.md

Call it with /restore-snapshot. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set33

The whole set →
swift-style swift-style — a skill for Claude Code, Codex, Cursor and other AI coding platforms that enforces Swift code style: naming, spacing, section order, guard patterns. Applied automatically when working with .swift files. CX Codex +1 1,500installs snapshot Captures what you've accomplished and writes a summary to .claude/snapshot.md. Use it to quickly restore context in the next session via the resume-snapshot command. CX Codex +1 ★ 233repo stars generating-swift-package-docs generating-swift-package-docs generates on-demand Swift package documentation from DerivedData when inspecting unfamiliar module imports. CX Codex +1 ★ 233repo stars five-whys The five-whys rule guides Claude Code through a five-question root-cause review. Use it when a visible failure needs a deeper process or system explanation. CX Codex +1 ★ 233repo stars swift-test-creator swift-test-creator writes unit and integration tests with Swift Testing — @Test, #expect, #require. Meant to run once the feature code is in place. CX Codex ★ 233repo stars swift-documenter swift-documenter is a Claude Code subagent that creates and updates README files and Swift doc comments after a feature is finished or during package documentation revisions. CX Codex ★ 233repo stars swift-modernizer The swift-modernizer subagent updates legacy Swift code toward async/await, modern APIs, and SwiftUI. Use it to plan and verify incremental migrations in an existing project. CX Codex ★ 233repo stars reflect reflect is a Claude Code command that reviews chat context and project settings, then suggests changes to instructions, commands, and configuration. CX Codex +1 ★ 233repo stars

Project sponsors

Companies that keep this analytics open