snapshot — Claude Code command: save session context
A command that 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.
MIT ★ 233 updated 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringWhat snapshot does
The command asks Claude to generate a handoff summary with four sections: what was accomplished (2–4 bullets), current state (branch, uncommitted changes, open tasks with IDs), decisions made, and a clear starting point. The summary stays under 250 words and uses IDs and file paths for quick reference.
This isn't a manual recap—Claude generates it based on what happened in your current session. The output goes into .claude/snapshot.md, where resume-snapshot can read it and pick up work without reloading the entire context.
Install via Claude Code's plugin marketplace or copy snapshot.md to .claude/commands/.
What it helps with
- capture work progress for the next session
- write a concise summary of branch and task status
- prepare a clear resumption point for later
Example prompts for the agent
- /snapshot
- Create a snapshot of the current project state
- Save a handoff summary before pausing work
How to install snapshot
1Plugin marketplace
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineering2Manually: put the files in place
.claude/commands/snapshot.mdCall it with /snapshot. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/snapshot.mdCall it with /prompts:snapshot. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/snapshot.prompt.mdManually: put the files in place
.gemini/commands/snapshot.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about snapshot
How do I install snapshot in Claude Code?
Run /plugin marketplace add johnrogers/claude-swift-engineering, then /plugin install swift-engineering@claude-swift-engineering. The command will appear in your available commands.
What does snapshot do?
It asks Claude to write a brief summary of what you've done: accomplishments, branch and task state, decisions, and where to start next. The summary goes into .claude/snapshot.md.
How do snapshot and resume-snapshot work together?
Before stopping work, run /snapshot to create a summary. When you return, run resume-snapshot, and Claude will read the snapshot and restore context without requiring a full history reload.
Source text
snapshot.md · MIT
description: Asks Claude to generate a snapshot summary for a future session. Writes it to file. It can then be read by the `resume-snapshot` command. disable-model-invocation: true --- Generate a handoff summary and write it to `.claude/snapshot.md`. ## Include: 1. **Summary** - What was accomplished (2-4 bullets) 2. **State** - Branch, uncommitted changes, open beads/tasks with IDs, any claude-mem references (if known) 3. **Decisions** - Any choices made or pending 4. **Next** - Clear starting point. Keep under 250 words. Use IDs and file paths for quick lookup. ## Output: Write the summary to `.claude/snapshot.md`.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering