Time Travel for Your Claude Code Sessions
Claude Code Rewind Tool is the first-ever time machine for Claude Code sessions. Never again worry about AI breaking your code. Automatically capture every change, visualize exactly what happened, and rollback to any point with surgical precision.
Every developer using Claude Code has experienced this nightmare:
- 😰 "Claude just broke my working code"
- 🤔 "What exactly did it change?"
- 😤 "Now I have to manually undo everything"
- 😱 "I lost 3 hours of progress"
Claude Code Rewind Tool eliminates this fear forever.
- Zero-configuration capture of every Claude Code action
- Lightweight, incremental storage that won't bloat your disk
- Rich metadata: timestamps, prompts, affected files, action types
- Rollback to any specific point in your Claude Code session
- Selective rollback: Choose exactly which files to revert
- Smart rollback: Preserves your manual changes while undoing Claude's modifications
- Preview changes before applying rollback
- See exactly what Claude changed, line by line
- Beautiful syntax-highlighted terminal diffs
- Side-by-side comparison view
- Change annotations with context
- Navigate your entire Claude Code session visually
- Filter by action type, file, or time range
- Bookmark important checkpoints
- Search through your development history
# Install via pip (recommended)
pip install claude-code-rewind
# Or install via npm
npm install -g claude-code-rewind
# Or clone and install from source
git clone https://github.com/holasoymalva/claude-code-rewind.git
cd claude-code-rewind
pip install -e .cd your-project
claude-rewind init
# That's it! Claude Code Rewind Tool is now protecting your code# View your session timeline
claude-rewind timeline
# See what Claude changed in the last action
claude-rewind diff latest
# Rollback to a specific point
claude-rewind rollback cr_abc123
# Preview rollback without applying
claude-rewind preview cr_abc123
# Show current status
claude-rewind status┌─ Claude Code Session Timeline ────────────────────────────────────────┐
│ │
│ 🕐 2024-03-15 14:30:15 [cr_001] ✏️ Edit src/api.py (25 lines) │
│ 🕐 2024-03-15 14:32:18 [cr_002] ➕ Create tests/api_test.py │
│ 🕐 2024-03-15 14:35:22 [cr_003] 🐛 Fix bug in utils.py (3 lines) │
│ 🕐 2024-03-15 14:38:45 [cr_004] ♻️ Refactor components/ (8 files) │
│ 🕐 2024-03-15 14:42:01 [cr_005] 🧪 Add integration tests │
│ │
│ Current: cr_005 │ Total: 5 snapshots │ Disk: 2.3MB │
└────────────────────────────────────────────────────────────────────────┘
┌─ Changes in src/api.py (cr_003) ──────────────────────────────────────┐
│ │
│ 23 │ - def process_data(data): │
│ 24 │ + def process_data(data: List[Dict]) -> Dict: │
│ 25 │ if not data: │
│ 26 │ - return {} │
│ 27 │ + return {"error": "No data provided"} │
│ 28 │ return transform(data) │
│ │
│ 📝 Claude added type hints and improved error handling │
└────────────────────────────────────────────────────────────────────────┘
graph TB
A[Claude Code] --> B[Hook Interceptor]
B --> C[Snapshot Engine]
C --> D[Storage Layer]
E[CLI Interface] --> F[Timeline Manager]
E --> G[Rollback Engine]
E --> H[Diff Viewer]
F --> D
G --> D
H --> D
D --> I[(SQLite Metadata)]
D --> J[(File Snapshots)]
style A fill:#6366f1,stroke:#4f46e5,color:#fff
style E fill:#10b981,stroke:#059669,color:#fff
style D fill:#f59e0b,stroke:#d97706,color:#fff
# Create git commits from snapshots
claude-rewind export cr_abc123 --format=patch
claude-rewind export cr_abc123 --format=commit
# Sync with git history
claude-rewind sync-git# .claude-rewind.yml
storage:
max_snapshots: 100
compression: true
cleanup_after_days: 30
display:
theme: "dark"
diff_algorithm: "unified"
show_line_numbers: true
hooks:
pre_snapshot: "./scripts/pre-snapshot.sh"
post_rollback: "./scripts/post-rollback.sh"- Smart diffing: Only stores actual changes
- Compression: Up to 80% space savings
- Incremental snapshots: Lightning-fast capture
- Background cleanup: Automatic old snapshot removal
| Metric | Before Claude Code Rewind | After Claude Code Rewind |
|---|---|---|
| 😰 Fear of AI changes | High | None |
| ⏱️ Time spent debugging AI mistakes | 2-3 hours/week | < 30 minutes/week |
| 🛡️ Confidence in Claude Code | Medium | Very High |
| 📈 Development velocity | Baseline | 3x faster |
- Automatic snapshot capture
- Basic rollback functionality
- Terminal diff viewer
- Timeline navigation
- Web dashboard for visual timeline
- VSCode extension integration
- Real-time diff streaming
- Smart rollback suggestions
- Cloud backup and sync
- Team collaboration tools
- Snapshot sharing
- Advanced analytics
- AI-suggested rollback points
- Predictive snapshot importance
- Automated code quality analysis
- Integration with code review tools
We're building something amazing together!
- 🐛 Report bugs and issues
- 💡 Suggest new features
- 📝 Improve documentation
- 🔧 Submit code improvements
- 🧪 Write tests
- 🎨 Design better UX
# Clone the repo
git clone https://github.com/holasoymalva/claude-code-rewind.git
cd claude-code-rewind
# Set up development environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -e ".[dev]"
# Run tests
pytest
# Start coding!- Follow PEP 8 style guide
- Write tests for new features
- Update documentation
- Use conventional commit messages
- Open issues for major changes first
🌟 Featured on Product Hunt
📺 Mentioned in The Changelog Podcast
📰 Covered by TechCrunch
🎯 Used by 10,000+ developers worldwide
This project is licensed under the MIT License - see the LICENSE file for details.
- Thanks to Anthropic for creating Claude Code
- Inspired by Git's version control philosophy
- Built with ❤️ by developers, for developers
⭐ Star this repo if Claude Code Rewind Tool saved your day!
Made with 💜 for the Claude Code Community