Skip to main content
command CX Codex

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

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

2Manually: put the files in place

.claude/commands/snapshot.md

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

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

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 restore-snapshot 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. 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