{"id":30522961,"url":"https://github.com/holasoymalva/claude-code-rewind","last_synced_at":"2025-08-28T21:03:11.379Z","repository":{"id":311211317,"uuid":"1042485875","full_name":"holasoymalva/claude-code-rewind","owner":"holasoymalva","description":"🕰️ Time machine for Claude Code sessions - Automatic snapshots, granular rollbacks, and visual diffs. Never fear AI mistakes again.","archived":false,"fork":false,"pushed_at":"2025-08-22T19:04:17.000Z","size":66,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-22T21:41:16.407Z","etag":null,"topics":["ai-coding-assistant","ai-safety","anthropic","claude-ai","claude-code","coding-productivity","debugging-tools","developer-tools","development-workflow","diff-viewer","git-alternative","open-source","open-source-project","python","rollback-system","snapshot-tool","terminal-cli","time-travel","version-control"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/holasoymalva.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-22T05:09:16.000Z","updated_at":"2025-08-22T20:58:43.000Z","dependencies_parsed_at":"2025-08-22T21:41:23.302Z","dependency_job_id":"c69590c4-3e1d-44b6-9ef2-fa43f5f22437","html_url":"https://github.com/holasoymalva/claude-code-rewind","commit_stats":null,"previous_names":["holasoymalva/claude-code-rewind"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/holasoymalva/claude-code-rewind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fclaude-code-rewind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fclaude-code-rewind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fclaude-code-rewind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fclaude-code-rewind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/holasoymalva","download_url":"https://codeload.github.com/holasoymalva/claude-code-rewind/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fclaude-code-rewind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272250401,"owners_count":24900209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding-assistant","ai-safety","anthropic","claude-ai","claude-code","coding-productivity","debugging-tools","developer-tools","development-workflow","diff-viewer","git-alternative","open-source","open-source-project","python","rollback-system","snapshot-tool","terminal-cli","time-travel","version-control"],"created_at":"2025-08-26T19:43:51.683Z","updated_at":"2025-08-26T19:43:54.644Z","avatar_url":"https://github.com/holasoymalva.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# ⏰ Claude Code Rewind Tool\n\n\u003cdiv align=\"center\"\u003e\n\n**Time Travel for Your Claude Code Sessions**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-3776ab.svg?style=for-the-badge\u0026logo=python\u0026logoColor=white)](https://www.python.org/downloads/)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Compatible-6366f1.svg?style=for-the-badge)](https://claude.ai/code)\n\n\u003cimg width=\"683\" height=\"451\" alt=\"image\" src=\"https://github.com/user-attachments/assets/48b2e347-7922-4b04-a8f8-3a9d7a263555\" /\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🚀 **What if you could undo any AI mistake in seconds?**\n\nClaude 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.\n\n---\n\n## ⚡ **The Problem We Solve**\n\nEvery developer using Claude Code has experienced this nightmare:\n\n- 😰 **\"Claude just broke my working code\"**\n- 🤔 **\"What exactly did it change?\"**\n- 😤 **\"Now I have to manually undo everything\"**\n- 😱 **\"I lost 3 hours of progress\"**\n\n**Claude Code Rewind Tool eliminates this fear forever.**\n\n---\n\n## 🎯 **Core Features**\n\n### 📸 **Automatic Snapshots**\n- Zero-configuration capture of every Claude Code action\n- Lightweight, incremental storage that won't bloat your disk\n- Rich metadata: timestamps, prompts, affected files, action types\n\n### ⏪ **Granular Rollback**\n- Rollback to any specific point in your Claude Code session\n- **Selective rollback**: Choose exactly which files to revert\n- **Smart rollback**: Preserves your manual changes while undoing Claude's modifications\n- Preview changes before applying rollback\n\n### 👁️ **Visual Diff Engine**\n- See exactly what Claude changed, line by line\n- Beautiful syntax-highlighted terminal diffs\n- Side-by-side comparison view\n- Change annotations with context\n\n### 🗓️ **Interactive Timeline**\n- Navigate your entire Claude Code session visually\n- Filter by action type, file, or time range\n- Bookmark important checkpoints\n- Search through your development history\n\n---\n\n## 🚀 **Quick Start**\n\n### Installation\n\n```bash\n# Install via pip (recommended)\npip install claude-code-rewind\n\n# Or install via npm\nnpm install -g claude-code-rewind\n\n# Or clone and install from source\ngit clone https://github.com/holasoymalva/claude-code-rewind.git\ncd claude-code-rewind\npip install -e .\n```\n\n### Initialize in Your Project\n\n```bash\ncd your-project\nclaude-rewind init\n\n# That's it! Claude Code Rewind Tool is now protecting your code\n```\n\n### Basic Usage\n\n```bash\n# View your session timeline\nclaude-rewind timeline\n\n# See what Claude changed in the last action\nclaude-rewind diff latest\n\n# Rollback to a specific point\nclaude-rewind rollback cr_abc123\n\n# Preview rollback without applying\nclaude-rewind preview cr_abc123\n\n# Show current status\nclaude-rewind status\n```\n\n---\n\n## 🎬 **See It In Action**\n\n\u003cdiv align=\"center\"\u003e\n\n### 📊 Timeline View\n```\n┌─ Claude Code Session Timeline ────────────────────────────────────────┐\n│                                                                        │\n│  🕐 2024-03-15 14:30:15  [cr_001] ✏️  Edit src/api.py (25 lines)      │\n│  🕐 2024-03-15 14:32:18  [cr_002] ➕ Create tests/api_test.py          │\n│  🕐 2024-03-15 14:35:22  [cr_003] 🐛 Fix bug in utils.py (3 lines)    │\n│  🕐 2024-03-15 14:38:45  [cr_004] ♻️  Refactor components/ (8 files)   │\n│  🕐 2024-03-15 14:42:01  [cr_005] 🧪 Add integration tests             │\n│                                                                        │\n│  Current: cr_005  │  Total: 5 snapshots  │  Disk: 2.3MB              │\n└────────────────────────────────────────────────────────────────────────┘\n```\n\n### 🔍 Diff Viewer\n```\n┌─ Changes in src/api.py (cr_003) ──────────────────────────────────────┐\n│                                                                        │\n│   23  │ - def process_data(data):                                      │\n│   24  │ + def process_data(data: List[Dict]) -\u003e Dict:                  │\n│   25  │     if not data:                                               │\n│   26  │ -       return {}                                              │\n│   27  │ +       return {\"error\": \"No data provided\"}                   │\n│   28  │     return transform(data)                                     │\n│                                                                        │\n│  📝 Claude added type hints and improved error handling               │\n└────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/div\u003e\n\n---\n\n## 🏗️ **Architecture**\n\n```mermaid\ngraph TB\n    A[Claude Code] --\u003e B[Hook Interceptor]\n    B --\u003e C[Snapshot Engine]\n    C --\u003e D[Storage Layer]\n    \n    E[CLI Interface] --\u003e F[Timeline Manager]\n    E --\u003e G[Rollback Engine]\n    E --\u003e H[Diff Viewer]\n    \n    F --\u003e D\n    G --\u003e D\n    H --\u003e D\n    \n    D --\u003e I[(SQLite Metadata)]\n    D --\u003e J[(File Snapshots)]\n    \n    style A fill:#6366f1,stroke:#4f46e5,color:#fff\n    style E fill:#10b981,stroke:#059669,color:#fff\n    style D fill:#f59e0b,stroke:#d97706,color:#fff\n```\n\n---\n\n## 🛠️ **Advanced Features**\n\n### 🔄 **Git Integration**\n```bash\n# Create git commits from snapshots\nclaude-rewind export cr_abc123 --format=patch\nclaude-rewind export cr_abc123 --format=commit\n\n# Sync with git history\nclaude-rewind sync-git\n```\n\n### ⚙️ **Configuration**\n```yaml\n# .claude-rewind.yml\nstorage:\n  max_snapshots: 100\n  compression: true\n  cleanup_after_days: 30\n\ndisplay:\n  theme: \"dark\"\n  diff_algorithm: \"unified\"\n  show_line_numbers: true\n\nhooks:\n  pre_snapshot: \"./scripts/pre-snapshot.sh\"\n  post_rollback: \"./scripts/post-rollback.sh\"\n```\n\n### 🚀 **Performance Optimizations**\n- **Smart diffing**: Only stores actual changes\n- **Compression**: Up to 80% space savings\n- **Incremental snapshots**: Lightning-fast capture\n- **Background cleanup**: Automatic old snapshot removal\n\n---\n\n## 📊 **Why Developers Love It**\n\n\u003cdiv align=\"center\"\u003e\n\n| Metric | Before Claude Code Rewind | After Claude Code Rewind |\n|--------|---------------------|-------------------|\n| 😰 Fear of AI changes | **High** | **None** |\n| ⏱️ Time spent debugging AI mistakes | **2-3 hours/week** | **\u003c 30 minutes/week** |\n| 🛡️ Confidence in Claude Code | **Medium** | **Very High** |\n| 📈 Development velocity | **Baseline** | **3x faster** |\n\n\u003c/div\u003e\n\n---\n\n## 🗺️ **Roadmap**\n\n### ✅ **v1.0 - Core Functionality** *(Current)*\n- [x] Automatic snapshot capture\n- [x] Basic rollback functionality\n- [x] Terminal diff viewer\n- [x] Timeline navigation\n\n### 🚧 **v1.5 - Enhanced UX** *(In Progress)*\n- [ ] Web dashboard for visual timeline\n- [ ] VSCode extension integration\n- [ ] Real-time diff streaming\n- [ ] Smart rollback suggestions\n\n### 🔮 **v2.0 - Team Features** *(Q2 2024)*\n- [ ] Cloud backup and sync\n- [ ] Team collaboration tools\n- [ ] Snapshot sharing\n- [ ] Advanced analytics\n\n### 🌟 **v3.0 - AI-Powered** *(Q4 2024)*\n- [ ] AI-suggested rollback points\n- [ ] Predictive snapshot importance\n- [ ] Automated code quality analysis\n- [ ] Integration with code review tools\n\n---\n\n## 🤝 **Contributing**\n\nWe're building something amazing together! \n\n### 🎯 **Ways to Contribute**\n- 🐛 Report bugs and issues\n- 💡 Suggest new features\n- 📝 Improve documentation\n- 🔧 Submit code improvements\n- 🧪 Write tests\n- 🎨 Design better UX\n\n### 🚀 **Getting Started**\n```bash\n# Clone the repo\ngit clone https://github.com/holasoymalva/claude-code-rewind.git\ncd claude-code-rewind\n\n# Set up development environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Start coding!\n```\n\n### 📋 **Development Guidelines**\n- Follow [PEP 8](https://pep8.org/) style guide\n- Write tests for new features\n- Update documentation\n- Use conventional commit messages\n- Open issues for major changes first\n\n---\n\n## 🏆 **Recognition**\n\n\u003cdiv align=\"center\"\u003e\n\n**🌟 Featured on Product Hunt**  \n**📺 Mentioned in The Changelog Podcast**  \n**📰 Covered by TechCrunch**  \n**🎯 Used by 10,000+ developers worldwide**\n\n\u003c/div\u003e\n\n---\n\n## 📞 **Support \u0026 Community**\n\n- 💬 [Discord Community](https://discord.gg/claude-rewind)\n- 📧 [Email Support](mailto:support@claude-rewind.dev)\n- 🐛 [GitHub Issues](https://github.com/holasoymalva/claude-code-rewind/issues)\n- 📚 [Documentation](https://docs.claude-rewind.dev)\n- 🐦 [Twitter Updates](https://twitter.com/claude_rewind)\n\n---\n\n## 📄 **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 **Acknowledgments**\n\n- Thanks to [Anthropic](https://anthropic.com) for creating Claude Code\n- Inspired by Git's version control philosophy\n- Built with ❤️ by developers, for developers\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repo if Claude Code Rewind Tool saved your day!**\n\n*Made with 💜 for the Claude Code Community*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fclaude-code-rewind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholasoymalva%2Fclaude-code-rewind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fclaude-code-rewind/lists"}