Revdiff: Terminal-Diff-Viewer mit Inline-Annotationen für KI-Agenten

Was Revdiff macht

Revdiff ist ein Terminal-Benutzeroberfläche (TUI) Diff-Viewer, der für einen speziellen Workflow entwickelt wurde: die Überprüfung von KI-generierten Codeänderungen, ohne die Terminal-Sitzung zu verlassen, in der der KI-Agent läuft. Das Tool ermöglicht es Ihnen, Zeilen, Abschnitte oder Dateien zu kommentieren und diese Anmerkungen direkt an den KI-Agenten zur Verarbeitung zurückzugeben.

Kern-Workflow

Aus einer Claude Code-Sitzung können Sie /revdiff main eingeben oder "review diff for last 3 commits" sagen, um revdiff als Terminal-Overlay über der Agenten-Sitzung zu öffnen. Nach dem Lesen des Diffs und dem Setzen von Anmerkungen beenden Sie das Tool, und die Anmerkungen gehen direkt zurück an den Agenten. Wenn der Agent die Änderungen abgeschlossen hat, öffnet revdiff automatisch die neuen Änderungen, wodurch ein kontinuierlicher Zyklus entsteht, bis Sie ohne Anmerkungen beenden.

Planungs-Integration

Ein separates revdiff-planning Plugin verbindet sich mit dem Planmodus von Claude Code. Wenn der Agent einen Plan beendet und ExitPlanMode aufruft, öffnet revdiff automatisch den Plantext. Sie können Teile kommentieren, mit denen Sie nicht einverstanden sind oder die erweitert werden sollen, beenden, und der Agent überarbeitet den Plan, bevor er Code schreibt.

Hauptmerkmale

• Zweiteilige TUI: Dateibaum links, syntaxhervorgehobener Diff rechts
• Vim-ähnliche Navigation mit /Suche, Sprung zwischen Abschnitten und Wortänderungs-Hervorhebung
• Blame-Ränder mit Autorennamen und Commit-Alter pro Zeile
• Zusammengefalteter Diff-Modus mit Endtext und Änderungsmarkierungen
• Zeilenumbruch-Modus mit Fortsetzungsmarkierungen
• Horizontale Scroll-Überlaufindikatoren mit « / » Markierungen
• Zeilennummern mit alten/neuen Rändern für Diffs nebeneinander
• Mercurial-Unterstützung mit automatischer Erkennung und git-ähnlicher Ref-Übersetzung
• Einzeldatei-Erkennung, die den Baumbereich ausblendet für volle Diff-Ansicht
• Anmerkungslisten-Popup zum Durchsuchen aller Anmerkungen über Dateien hinweg
• Statuszeile mit Dateiname, Diff-Statistiken, Abschnittsposition und Modusindikatoren
• Hilfe-Overlay mit allen Tastenkürzeln nach Bereichen geordnet
• Markdown-Inhaltsverzeichnis-Navigation für einzelne Markdown-Dateien
• Alle-Dateien-Modus zum Durchsuchen und Kommentieren aller git-verfolgten Dateien
• Kein-git Datei-Review für Dateien außerhalb von Repositories
• Scratch-Buffer-Review für beliebige gepipte oder umgeleitete Texte
• Review-Verlauf automatisch gespeichert in ~/.config/revdiff/history/

Anpassung

Revdiff bietet 7 gebündelte Farbthemen, neu belegbare Tastenkürzel und pro-Farb-Überschreibungen über CLI-Flags, Umgebungsvariablen oder Konfigurationsdatei. Sie können Standard-Tastenkürzel mit --dump-keys exportieren.

Installation und Verwendung

Installation über Homebrew: brew install umputun/apps/revdiff. Das Tool ist eine einzelne Binärdatei - führen Sie einfach revdiff HEAD~3 aus, um Ihre letzten 3 Commits zu überprüfen. Es funktioniert mit git- und Mercurial-Repositories.

Plugin-Unterstützung

Einsatzbereite Plugins sind verfügbar für Claude Code (Terminal-Overlay via tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2 oder Emacs vterm), Codex und pi. Das Claude Code Plugin erfordert einen der unterstützten Terminals, da Claude Code selbst keine interaktiven TUI-Anwendungen anzeigen kann.

Technische Details

Geschrieben in Go und Open Source unter MIT-Lizenz. Benötigt git oder hg zum Erzeugen von Diffs (optional bei Verwendung von --only oder --stdin).