claude-code-checkpointing

name	claude-code-checkpointing
description	Use when you need to undo code edits, explore alternatives without losing a starting point, recover from a bad edit path, or restore previous conversation state — press Esc Esc or run /rewind to open checkpoints menu.
user-invocable	true

Claude Code Checkpointing and Rewind

What It Does

Checkpointing automatically snapshots your code state before each Claude edit. You can rewind to any prior checkpoint to restore code and/or conversation history, or compress part of the conversation to free context without changing files.

How It Works

• Every user prompt creates a new checkpoint automatically
• Checkpoints track only direct file edits made by Claude (via Edit/Write/MultiEdit tools)
• Checkpoints do NOT track bash commands (rm, mv, cp, etc.) or manual edits outside Claude Code
• Checkpoints persist across sessions (stored 30 days by default; configurable)
• External side effects (DB changes, git pushes, emails) are never undone by rewind

Invoke Rewind

Command: /rewind or press Esc twice when the prompt input is empty

Opens a menu listing every prompt in the session. Select one, then choose an action:

Action	Effect
Restore code and conversation	Revert both file edits and chat history to that point
Restore conversation	Keep current code, rewind chat to that point
Restore code	Keep chat, revert file edits to that point
Summarize from here	Compress this message onward into a summary; keep earlier messages intact
Summarize up to here	Compress everything before this message into a summary; stay at end of chat
Never mind	Return to menu without changing anything

After restore, the original prompt from that checkpoint is placed in your input field for re-sending or editing.

Restore vs. Summarize

Restore = undo. Reverts file state (or conversation, or both) on disk.

Summarize = compress. Replaces old messages with an AI-generated summary. Original detail is preserved in the transcript so Claude can reference it, but the context window is freed. Optionally guide the summary with your own instructions. (Similar to /compact, but targeted to one side of a checkpoint.)

When to Use

• Explore alternatives: try a different implementation, then rewind if it doesn't work
• Recover from mistakes: undo a broken edit path without manually reverting files
• Iterate safely: experiment knowing you can snap back to a working state
• Free context: compress verbose early discussion while keeping recent work in full detail

Limitations

Bash changes are not tracked. If Claude (or you) runs:

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

Rewind cannot undo these — only Claude's direct file edits are captured.

Manual and concurrent edits not tracked. Changes made outside Claude Code (in an editor or other session) are not captured unless they happen to touch the same files Claude edited.

Not a replacement for git. Checkpoints are session-local undo. For permanent history, collaboration, and long-term safety:

• Use git for commits, branches, permanent history
• Use checkpoints for quick session-level recovery ("local undo")

How It Integrates With Git

• Checkpoints operate at the session level; they don't interact with git directly
• Global git hooks (ruff/vulture on Python) run on commits and code review, independent of checkpointing
• Rewind restores files to their in-memory state, but doesn't stage or commit; use /commit to save after restoring
• For multi-session safety, commit working code to git before stepping away; checkpoints expire after 30 days

Safe Mental Model

• Use /rewind to recover from a bad edit path within the current session
• Use /fork-session (or --fork-session flag) to try a direction while preserving the original session
• Use git reset or revert for permanent history recovery
• Use /compact to summarize the entire conversation; use /rewind summarize to compress a specific section