⏰ Claude Code Rewind Tool

Time Travel for Your Claude Code Sessions

🚀 What if you could undo any AI mistake in seconds?

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.

⚡ The Problem We Solve

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.

🎯 Core Features

📸 Automatic Snapshots

• 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

⏪ Granular Rollback

• 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

👁️ Visual Diff Engine

• See exactly what Claude changed, line by line
• Beautiful syntax-highlighted terminal diffs
• Side-by-side comparison view
• Change annotations with context

🗓️ Interactive Timeline

• Navigate your entire Claude Code session visually
• Filter by action type, file, or time range
• Bookmark important checkpoints
• Search through your development history

🚀 Quick Start

Installation

# Clone and install directly (no virtual environment needed!)
git clone https://github.com/holasoymalva/claude-code-rewind.git
cd claude-code-rewind
pip install -e .

# Verify installation
claude-rewind --help

🎯 That's it! The claude-rewind command is now available globally.

📚 Full Installation Guide - Detailed instructions, troubleshooting, and advanced options.

Initialize in Your Project

cd your-project
claude-rewind init

# Choose your monitoring approach:

# Option A: Event-driven (recommended for Claude Code 2.0+)
claude-rewind hooks init
# ✓ Zero-latency snapshots
# ✓ Rich context capture
# ✓ No background process needed

# Option B: Polling (fallback for older versions)
claude-rewind monitor
# Background monitoring every 2 seconds

# That's it! Claude Code Rewind Tool is now protecting your code

Basic Usage

# 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

🎬 See It In Action

┌─ 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               │
└────────────────────────────────────────────────────────────────────────┘

🏗️ Architecture

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

🛠️ Advanced Features

🔄 Git Integration

# 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

⚙️ Configuration

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

🚀 Performance Optimizations

• Smart diffing: Only stores actual changes
• Compression: Up to 80% space savings
• Incremental snapshots: Lightning-fast capture
• Background cleanup: Automatic old snapshot removal

📊 Why Developers Love It

🗺️ Roadmap

✅ v1.0 - Core Functionality (Complete - All 12/12 CLI Commands Working)

• Automatic snapshot capture with intelligent Claude Code detection
• Complete rollback functionality with selective file rollback
• Advanced terminal diff viewer with syntax highlighting
• Interactive timeline navigation (both terminal and non-interactive modes)
• Smart cleanup system with age and count-based management
• Comprehensive configuration and validation system
• Hook system with extensible plugin architecture
• Git integration with automatic commit generation
• Performance optimizations (incremental, parallel, lazy loading)
• Professional error handling and logging

✅ v1.5a - Native Hooks Support (Complete)

• Event-driven snapshot creation (zero latency)
• Rich context capture (extended thinking, confidence scores)
• Subagent-aware tracking
• Auto-rollback suggestions on errors
• Session lifecycle management
• CLI commands for hook management

📚 Native Hooks Guide - Complete documentation on event-driven snapshots

🚧 v1.5b - Web Dashboard (In Progress)

• Visual timeline with D3.js
• Real-time snapshot monitoring
• Advanced diff viewer with Monaco Editor
• Interactive rollback interface

🔮 v1.5c - Real-Time Streaming (Planned)

• WebSocket-based live diff streaming
• Watch mode for continuous monitoring
• Smart rollback suggestions

🔮 v2.0 - Team Features (Q2 2024)

• Cloud backup and sync
• Team collaboration tools
• Snapshot sharing
• Advanced analytics

🌟 v3.0 - AI-Powered (Q4 2024)

• AI-suggested rollback points
• Predictive snapshot importance
• Automated code quality analysis
• Integration with code review tools

🤝 Contributing

We're building something amazing together!

🎯 Ways to Contribute

• 🐛 Report bugs and issues
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit code improvements
• 🧪 Write tests
• 🎨 Design better UX

🚀 Getting Started

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

📋 Development Guidelines

• Follow PEP 8 style guide
• Write tests for new features
• Update documentation
• Use conventional commit messages
• Open issues for major changes first

🏆 Recognition

📚 Documentation

• 📖 Usage Guide - Complete CLI reference and workflows
• 🎣 Native Hooks Guide - Event-driven snapshots with Claude Code 2.0
• 🔧 API Reference - Technical reference for developers
• 🚀 Installation Guide - Detailed setup instructions
• 🗺️ Complete Roadmap - Future development plans

📞 Support & Community

• 🐛 GitHub Issues
• 📧 Email: support@jpotterlabs.com

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Thanks to Anthropic for creating Claude Code
• Inspired by Git's version control philosophy
• Built with ❤️ by developers, for developers