# Checkpoint Manager

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

- Skill: `majiayu000/checkpoint-manager-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/checkpoint-manager-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/checkpoint-manager-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/checkpoint-manager-3

---


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