checkpoint

# Checkpoint: Save & Restore Task State ## Subcommands ### save [label] Save current state with an optional label. ```bash bun ~/.claude/src/scripts/checkpoint.ts save "Completed phase 3 migration" ``` ### list List all checkpoints for the current project. ```bash bun ~/.claude/src/scripts/checkpoint.ts list ``` ### show [checkpoint-id] Show details of a specific checkpoint. ```bash bun ~/.claude/src/scripts/checkpoint.ts show chk-20240115-103000 ``` ### restore [checkpoint-id] [--force] Real, opt-in rollback — restores tracked files (working tree + index) to exactly what they were at save time, then reapplies whatever uncommitted changes existed at that moment (captured as a patch when the checkpoint was saved). Untracked files are never touched or deleted; if any existed at save time they're just listed as a warning (their content was never captured). Scope note: restore reconstructs file *content* only — anything that was staged at save time comes back as unstaged working-tree changes (the patch reapplies to the worktree; index state is intentionally not reconstructed). Safety rails: - **Auto safety-checkpoint first.** Before anything is touched, the current state is saved as its own checkpoint and its id is printed — restore is itself reversible by restoring that id (with `--force`). - **Branch/sha guard.** If the current branch or HEAD differs from what the checkpoint recorded, restore refuses and tells you to check out that branch or pass `--force`....