Omnidiff bringt strukturelles und binäres Diffing ins Terminal

Marko Ivankovic hat Omnidiff veröffentlicht, ein leistungsstarkes Diff-Tool in Rust, das über den traditionellen Textvergleich hinausgeht. Das am 1. November 2026 veröffentlichte Tool zielt darauf ab, robuste und präzise Unterschiede sowohl für Quellcode als auch für Binärdateien wie Bilder, Schriftarten und Archive bereitzustellen.

Was ist passiert

Die Veröffentlichung führt eine Befehlszeilenschnittstelle (CLI) und eine Terminal-Benutzeroberfläche (TUI) ein, die entwickelt wurden, um zwanzig reale Codeänderungen sowie verschiedene Binärformate zu verarbeiten. Im Gegensatz zu Standard-Unix-Diff-Tools, die Dateien als Zeilen von Text behandeln, analysiert Omnidiff Inhalte basierend auf ihrem Typ. Es unterstützt das strukturelle Diffing für fünfundzwanzig Programmiersprachen und bietet visuelle Vergleiche für Binärdateien, einschließlich einer Pixel-für-Pixel-Analyse für Bilder und einer Zeichen-für-Zeichen-Inspektion für Schriftarten.

Die Leistung steht im Mittelpunkt des Projekts. Benchmarks, die auf einem T14s-Laptop mit einem Intel Core i7-1370P-Prozessor und 32 GB RAM durchgeführt wurden, zielen auf eine mediane Diff-Zeit von unter 100 Millisekunden ab. Die Latenz im 99. Perzentil ist auf 1000 Millisekunden begrenzt. Das Tool ist über vorgefertigte Binaries für Linux, macOS und Windows sowie über Paketmanager wie Homebrew, Nix und apt verfügbar.

Wie es funktioniert

Omnidiff erkennt Dateitypen anhand von Erweiterungen für Text und Byte-Signaturen für Binärdaten. Für Quellcode verwendet es tree-sitter-Grammatiken, um fünfundzwanzig Sprachen zu parsen, darunter Rust, Python, JavaScript und C++. Dies ermöglicht es dem Tool, die Struktur des Codes zu verstehen und Änderungen innerhalb von Funktionen, Klassen oder Structs zu identifizieren, anstatt nur Verschiebungen von Zeilen zu melden. Wenn eine Änderung tief in einer großen Datei stattfindet, stellt das Tool den diff-Hunk mit der nächstliegenden einschließenden Definition voran, um Kontext zu bieten.

Bei Binärdateien variiert der Ansatz je nach Format. Bilder in PNG-, JPEG-, GIF- und anderen Formaten werden Pixel für Pixel oder bei Animationen Frame für Frame verglichen. Archive wie zip und tar werden Element für Element inspiziert, wobei verschachtelte Archive durchlaufen werden können. Schriftarten werden Zeichen für Zeichen analysiert, wobei nur die spezifischen geänderten Charaktere angezeigt werden. Die TUI rendert diese Visualisierungen unter Verwendung von Terminal-Grafikprotokollen wie kitty oder sixel, wenn verfügbar, und fällt andernfalls auf Unicode-Halbblockzeichen zurück.

Wichtige Details

• Strukturelles Parsen: Unterstützt fünfundzwanzig Sprachen über tree-sitter, einschließlich C, Go, Java und TypeScript, und bietet kontextbewusste Diffs.
• Binäre Unterstützung: Verarbeitet Bilder, Schriftarten, Archive, PDFs und Nachrichtenkataloge durch Vergleich ihrer internen Strukturen anstelle von Rohbytes.
• Leistungsziele: Zielt auf eine mediane Diff-Zeit von 100 ms und eine Zeit im 99. Perzentil von 1000 ms auf moderner Hardware ab.
• Integration: Funktioniert als Backend für git difftool und jj diff, mit Einrichtungsassistenten für die Versionskontrollsysteme Git und Jujutsu.
• Ausgabemodi: Bietet eine interaktive TUI, einen Headless-Batch-Modus für Skripte und JSON-Ausgabe für programmatische Nutzung.
• Lizenzierung: Veröffentlicht unter der GNU Affero General Public License Version 3, mit einer kommerziellen Abonnementoption über GitHub Sponsors.

Warum es wichtig ist

Für Software-Ingenieure besteht die Einschränkung traditioneller Diff-Tools darin, dass sie Nicht-Text-Assets nicht sinnvoll vergleichen können. Änderungen an Icons, Schriftarten oder kompilierten Ressourcen erfordern oft das Öffnen separater grafischer Tools zur Überprüfung. Omnidiff konsolidiert diesen Workflow im Terminal und ermöglicht es Entwicklern, visuelle Änderungen neben Code-Änderungen in einer einzigen Oberfläche zu überprüfen. Dies reduziert Kontextwechsel und beschleunigt den Review-Prozess für Full-Stack-Anwendungen, die Design-Assets enthalten.

Das strukturelle Bewusstsein des Tools verbessert auch die Genauigkeit des Code-Reviews. Durch das Verständnis der Syntax der Sprache kann es irrelevante Leerzeichen- oder Formatierungsänderungen ignorieren, die oft Standard-Diffs verunreinigen. Dies hilft Reviewern, sich auf logische Änderungen statt auf stilistisches Rauschen zu konzentrieren. Darüber hinaus stellt die Integration mit modernen Versionskontrollsystemen wie Jujutsu sicher, dass Nutzer neuartiger Tools ein konsistentes Review-Erlebnis beibehalten können.

Was Sie tun können

• Installieren Sie Omnidiff über Ihren System-Paketmanager, z. B. brew install ivankovic/omnidiff/omnidiff auf macOS oder das bereitgestellte apt-Repository für Debian.
• Konfigurieren Sie es als Ihr Standard-git-difftool, indem Sie omnidiff git configure ausführen, um interaktive Reviews für Git-Repositories zu aktivieren.
• Nutzen Sie den Headless-Modus mit omnidiff --headless BEFORE AFTER in CI-Pipelines, um Klartext-Diffs für automatisierte Prüfungen zu generieren.
• Untersuchen Sie binäre Änderungen, indem Sie Bild- oder Schriftartdateien an die TUI übergeben, um Pixel- oder Zeichenunterschiede zu sehen, ohne das Terminal zu verlassen.
• Setzen Sie die Umgebungsvariable COLORTERM=truecolor, wenn Ihr Terminal 24-Bit-Farben unterstützt, dies aber nicht angibt, um optimale visuelle Qualität zu gewährleisten.
• Überprüfen Sie das JSON-Schema in src/tui/json_output.schema.json, wenn Sie planen, die Ausgabe von Omnidiff in eigene Tools oder Dashboards zu integrieren.