⏪
Rewind & Checkpoints
Undo agent actions and recover from mistakes using the rewind feature.
Why Rewind Matters
Agents make mistakes. They might take a wrong approach, produce broken code, or go in an unproductive direction. The rewind feature lets you undo actions and return to a previous state without losing the ability to try a different approach.
How Rewind Works
- ▸Claude Code creates automatic checkpoints as it works
- ▸Each checkpoint captures the state of changed files
- ▸The rewind command lets you go back to any previous checkpoint
- ▸After rewinding, you can give new instructions and try a different approach
- ▸The conversation context is also rolled back to match the checkpoint
When to Use Rewind
| Scenario | Action |
|---|---|
| Claude took a wrong architectural approach | Rewind to before the implementation started |
| A refactor broke existing functionality | Rewind and ask for a more targeted change |
| Too many files were modified unnecessarily | Rewind and provide more specific instructions |
| You want to compare two different approaches | Implement one, rewind, implement the other |
ℹ️Info
Enable Checkpointing in /config settings. This ensures rewind points are created automatically, giving you a safety net during long coding sessions.