revert-ai

Intelligent undo/redo for AI coding assistants — Revert individual file operations with AST-based cascading safety, visual side-by-side diffs, and Git stashing.

revert-ai seamlessly integrates with popular AI command-line coders to provide granular undo and redo functionality. It parses active session logs (or git history) to track file operations, letting you selectively revert or restore changes without losing unrelated work.

✨ Features

• 🤖 Multi-Agent Support — Reads directly from Claude Code session logs and parses Aider git commits.
• ✨ AST-based Cascading — Analyzes imports and file dependencies in JS/TS and Python. Reverting a change only undoes subsequent steps that actually depend on it, rather than wiping out all unrelated edits.
• 📋 Visual Side-by-Side Diff — Displays clear column-based terminal diffs comparing your current file state with the proposed reverted state before you confirm.
• 💾 Git Workspace Safety — Automatically detects uncommitted changes and prompts to save your work to a Git stash before performing an undo.
• Complete Redo System — Reverse any undo operation with full cascading support.
• 🌍 Multi-language — Supports English, Japanese (日本語), French, Spanish, and German out of the box.

Installation

npm install -g revert-ai

Quick Start

1. Navigate to any project directory where you have run Claude Code or Aider.
2. List recent operations:

   revert-ai list

3. Interactive preview with side-by-side terminal diffs:

   revert-ai preview

4. Revert changes safely:

   revert-ai undo

5. Redo previously undone operations:

   revert-ai redo

Commands

List Operations

Show recent tool-use edits or commits:

revert-ai list
revert-ai list --all             # Include already undone operations

Preview Changes

Compare files side-by-side in your terminal:

revert-ai preview                 # Interactive selection
revert-ai preview <operation-id>  # Preview specific operation

Undo Operations

Revert files safely with dependency tracing and Git stashing:

revert-ai undo                    # Interactive selection with preview
revert-ai undo <operation-id>     # Revert specific operation
revert-ai undo --yes              # Skip confirmation prompts

Session Management

Switch between active AI coding sessions:

revert-ai sessions              # List all sessions
revert-ai session <session-id>  # Switch to a specific session

Language Settings

Configure your CLI language:

revert-ai language              # Show current language and options
revert-ai language ja           # Switch to Japanese

How It Works

1. Auto-Detection — revert-ai inspects your directory for .aider.chat.history.md or Claude Code session logs to load the appropriate parser.
2. Import Resolution — It resolves imports/requires for Javascript, TypeScript, and Python.
3. Dependency Cascading — When you choose to undo a file edit, the dependency resolver walks the import graph to see if later edits depend on it. If so, they are cascaded; if not, they are untouched.
4. Git Stashing — If your git index is dirty, revert-ai stashes your uncommitted work so you never lose manual edits.

License

MIT © Harsha Rajkumar