RALPH-ROLLBACK - Rollback to Checkpoint
Rollback RALPH to a previous checkpoint, discarding work since then.
Commands
| Command | Description |
|---|---|
/ralph-rollback | Rollback to last good checkpoint |
/ralph-rollback cp-123456 | Rollback to specific checkpoint |
/ralph-rollback --list | List available checkpoints |
Process
- •List available checkpoints
- •User selects checkpoint (or default to last)
- •Remove checkpoints after target
- •Update completed subtasks list
- •Git reset if needed
- •Set state to PAUSED
List Checkpoints
code
╔════════════════════════════════════════════════════════════════╗
║ Available Checkpoints ║
╚════════════════════════════════════════════════════════════════╝
Checkpoints (newest first):
[3] cp-1706180600000 - ST-001-3 (2026-01-25 10:30:00)
Changes: +45 lines, 2 files
[2] cp-1706180400000 - ST-001-2 (2026-01-25 10:20:00)
Changes: +32 lines, 1 file
[1] cp-1706180200000 - ST-001-1 (2026-01-25 10:10:00)
Changes: +15 lines, 1 file
Select checkpoint to rollback to:
Rollback Confirmation
code
╔════════════════════════════════════════════════════════════════╗ ║ Rollback Confirmation ║ ╚════════════════════════════════════════════════════════════════╝ ⚠ You are about to rollback to: cp-1706180400000 (ST-001-2) This will DISCARD: - ST-001-3 work (+45 lines, 2 files) - 1 checkpoint Git status: - Will revert 1 commit - Uncommitted changes will be lost ? Proceed with rollback? ○ Yes, rollback (I understand changes will be lost) ○ No, cancel
Rollback Complete
code
╔════════════════════════════════════════════════════════════════╗ ║ Rollback Complete ║ ╚════════════════════════════════════════════════════════════════╝ ✓ Rolled back to: cp-1706180400000 Removed: - 1 checkpoint - 1 completed subtask Current state: Status: ⏸️ PAUSED Last completed: ST-001-2 Next subtask: ST-001-3 To continue: /ralph-resume
Use Cases
- •Implementation went wrong direction
- •Tests are failing after changes
- •Need to try different approach
- •Discovered better solution