claudekit/.claude/skills/session-management/references/checkpoints.md

Checkpoints

Save Checkpoint

/checkpoint save [name]

Creates a git stash with metadata in .claude/checkpoints/[name].json:

{
  "name": "feature-auth",
  "created": "2026-04-19T14:30:00Z",
  "git_stash": "stash@{0}",
  "files_in_context": ["src/auth/login.ts", "src/auth/token.ts"],
  "current_task": "Implementing JWT refresh",
  "notes": "User-provided notes"
}

List Checkpoints

/checkpoint list

Restore Checkpoint

/checkpoint restore [name]

Applies git stash, loads metadata, summarizes restored context.

Delete Checkpoint

/checkpoint delete [name]

Auto-Checkpoint Triggers

Suggest checkpoints before:

• Major refactoring
• Context switches
• Risky operations
• Natural breakpoints in complex work