Checkpoint

Capture and restore working state to prevent context pollution.

Commands

/checkpoint save [name]

Save current state. Name optional (auto-generates if omitted). Suggest checkpointing when context is growing large or before risky changes.

1. Generate or use provided name (kebab-case, 2-3 words)
2. Ensure dir exists: mkdir -p ~/.local/state/claude/checkpoints
3. Create ~/.local/state/claude/checkpoints/<name>-<YYYYMMDD-HHMM>.md
4. Write:

# Checkpoint: <name>
Date: <timestamp>
CWD: <pwd>

## Goal
<1-2 sentence summary>

## Current State
- <what's working/tested>
- <files changed>
- Diff stat: <output of `git diff --stat`>
- Last green commit: <SHA where tests last passed>

## Key Decisions
- <decisions and rationale>

## Gotchas
- <pitfalls discovered>

## Next Steps
- <what to do when resuming>

5. Confirm: "Saved: <filepath>"