checkpoint

# Checkpoint: Save & Restore Task State ## Product-aware runner Set these once for the active host. `checkpoint.ts` uses `claudePath`, so pass the matching state root on every invocation. ```bash # Standalone Codex CHECKPOINT_RUNNER="${CODEX_HOME:-$HOME/.codex}/darkroom/source/src/scripts/checkpoint.ts" CC_STATE_ROOT="${CODEX_HOME:-$HOME/.codex}/darkroom/state" # Claude Code instead uses: # CHECKPOINT_RUNNER="$HOME/.claude/src/scripts/checkpoint.ts" # CC_STATE_ROOT="$HOME/.claude" ``` ## Subcommands ### save [label] Save current state with an optional label. ```bash CC_SETTINGS_HOME="$CC_STATE_ROOT" bun "$CHECKPOINT_RUNNER" save "Completed phase 3 migration" ``` ### list List all checkpoints for the current project. ```bash CC_SETTINGS_HOME="$CC_STATE_ROOT" bun "$CHECKPOINT_RUNNER" list ``` ### show [checkpoint-id] Show details of a specific checkpoint. ```bash CC_SETTINGS_HOME="$CC_STATE_ROOT" bun "$CHECKPOINT_RUNNER" 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 unst...