Agent skill
ralph-rollback
Rollback to a previous checkpoint
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ralph-rollback
SKILL.md
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
╔════════════════════════════════════════════════════════════════╗
║ 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
╔════════════════════════════════════════════════════════════════╗
║ 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
╔════════════════════════════════════════════════════════════════╗
║ 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?