Agent skill

checkpoint-manager

Session checkpoint management: save, restore, list, clear state snapshots

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/checkpoint-manager

SKILL.md

v2.88 Key Changes (MODEL-AGNOSTIC)

  • Model-agnostic: Uses model configured in ~/.claude/settings.json or CLI/env vars
  • No flags required: Works with the configured default model
  • Flexible: Works with GLM-5, Claude, Minimax, or any configured model
  • Settings-driven: Model selection via ANTHROPIC_DEFAULT_*_MODEL env vars

Checkpoint Manager

Manage session state checkpoints for the Ralph orchestration system.

Subcommands

save - Create checkpoint

/checkpoint save "before-refactor"
@cp save "Pre-deployment state"

restore - Restore checkpoint

/checkpoint restore "before-refactor"
@cp restore cp_20260107_143015

list - List all checkpoints

/checkpoint list
@cp list

clear - Remove checkpoint(s)

/checkpoint clear "old-checkpoint"
@cp clear --all

Storage

Checkpoints are stored in ~/.ralph/checkpoints/ as JSON files.

Output Examples

Save Output

✅ Checkpoint saved: cp_20260214_143015_before-refactor
📁 Location: ~/.ralph/checkpoints/cp_20260214_143015.json
⏱️  Expires: 24 hours (2026-02-15 14:30:15)

List Output

╭───────────────────────────────────────────────────────╮
│                  CHECKPOINTS (3)                       │
├───────────────────────────────────────────────────────┤
│ cp_20260214_143015  │ before-refactor      │ 2h ago  │
│ cp_20260214_120000  │ pre-deployment       │ 5h ago  │
│ cp_20260213_180000  │ feature-complete     │ 1d ago  │
╰───────────────────────────────────────────────────────╯

Workflow Integration

/checkpoint save "Before risky changes"
  ↓ (make changes)
/checkpoint restore "Before risky changes"  # if needed
  ↓ (or continue)
/checkpoint clear "Before risky changes"   # cleanup

Related Skills

  • /orchestrator - Full orchestration workflow
  • /loop - Iterative execution with checkpointing
  • /gates - Quality validation before checkpoints

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results