🔄 Crevr

A beautiful web-based UI for reviewing and reverting Claude Code changes. Think of it as "git diff" but for your Claude conversations.

✨ Features

• 🔍 Visual Diff Viewer - See exactly what Claude changed with before/after comparisons
• 🎯 Selective Reversion - Revert individual changes or entire files
• 📁 File Tree - Organized view of all modified files
• 🗂️ Two View Modes - Diff view and inline view for different perspectives
• 💾 Persistent Tracking - Reverted changes stay hidden (never modifies Claude logs)
• 🔄 Smart Recovery - Restore deleted files or undo unwanted modifications
• ⚡ Real-time Updates - See changes as they happen
• 🌐 Web-based - Works in any browser, no IDE integration needed

🚀 Quick Start

Install globally via npm:

npm install -g crevr

Use in any directory where Claude Code has been used:

# Navigate to your project directory
cd /your/project

# Start Crevr (opens in browser automatically)
crevr

# Or specify a custom port
crevr --port 8080

# Don't auto-open browser
crevr --no-open

That's it! Crevr will scan your Claude Code session and show you all the changes.

🛠️ How It Works

Crevr reads your Claude Code session files (stored in ~/.claude/projects/) and presents all file changes in an intuitive web interface. It never modifies your original Claude logs - reverted changes are tracked separately in ~/.crevr/.

Key Concepts:

• Changes are grouped by file - See all modifications to each file
• Each change shows exactly what was modified - Before/after text with diff highlighting
• Reverting is permanent - Reverted changes disappear from the UI and stay hidden
• File recovery - Deleted files can be restored by reverting their deletion

🔧 CLI Options

crev [options]

Options:
  -p, --port <port>    Port to run the server on (default: 3456)
  --no-open           Don't automatically open the browser
  -V, --version       Output the version number
  -h, --help          Display help information

Additional Commands

# List recent changes in terminal (no UI)
crevr list

🎯 Use Cases

• Review Claude's changes before committing - See exactly what was modified
• Selective cleanup - Keep the good changes, revert the problematic ones
• File recovery - Restore accidentally deleted files
• Change auditing - Track what Claude has done to your codebase
• Learning tool - Understand how Claude approaches code modifications

🤝 Comparison with Similar Tools

| Feature | Crevr | ccundo | Claude Code Diff | |---------|------|---------|------------------| | Web UI | ✅ | ❌ | ❌ | | Visual diffs | ✅ | ❌ | ✅ | | Selective revert | ✅ | ✅ | ❌ | | File recovery | ✅ | ✅ | ❌ | | Persistent state | ✅ | ✅ | ❌ | | Real-time updates | ✅ | ❌ | ❌ |

🔒 Privacy & Security

• Local only - Crevr runs entirely on your machine
• No data collection - Nothing is sent to external servers
• Safe operations - Original Claude logs are never modified
• File access - Only reads files in your current working directory

🐛 Troubleshooting

No changes showing?

• Make sure you're in a directory where Claude Code has been used
• Check that ~/.claude/projects/ contains session files
• Try the crevr list command to see if changes are detected

Browser doesn't open?

• Use crevr --no-open and manually visit the URL shown
• Check if another process is using the port (crevr --port 8080)

Revert not working?

• Check file permissions in your project directory
• Ensure the file hasn't been manually modified since Claude's change

🛣️ Roadmap

• [ ] Undo reverts (re-apply changes)
• [ ] Export diffs to patch files
• [ ] Integration with git workflows
• [ ] Support for multiple Claude sessions
• [ ] Dark/light theme toggle
• [ ] Keyboard shortcuts

🤝 Contributing

Found a bug or have a feature request? Please open an issue on GitHub.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Inspired by ccundo for the revert tracking approach
• Built for the Claude Code community

Made with ❤️ for Claude Code users