# Checkpoint Manager

> Checkpoint Manager is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `checkpoint-manager`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/context-management/checkpoint-manager/SKILL.md
- Repository: majiayu000/claude-skill-registry (498 GitHub stars when collected)

## 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

---

Source: https://www.openparable.com/skill/productivity/checkpoint-manager (OpenParable). Cite the canonical URL above.
