Revdiff : Visualiseur de Différences en Terminal avec Annotations Inline pour Agents IA

Ce que fait Revdiff

Revdiff est une interface utilisateur terminal (TUI) de visualisation de différences conçue pour un flux de travail spécifique : examiner les modifications de code générées par l'IA sans quitter la session terminal où l'agent IA s'exécute. L'outil vous permet d'annoter des lignes, des blocs ou des fichiers et de renvoyer ces annotations directement à l'agent IA pour traitement.

Flux de travail principal

Depuis une session Claude Code, vous pouvez taper /revdiff main ou dire "examiner les différences pour les 3 derniers commits" pour ouvrir revdiff comme une superposition terminal au-dessus de la session de l'agent. Après avoir lu les différences et ajouté des annotations, vous quittez, et les annotations sont renvoyées directement à l'agent. Lorsque l'agent termine d'apporter des modifications, revdiff se rouvre automatiquement sur les nouvelles modifications, créant une boucle continue jusqu'à ce que vous quittiez sans laisser d'annotations.

Intégration de planification

Un plugin séparé revdiff-planning se connecte au mode plan de Claude Code. Lorsque l'agent termine un plan et appelle ExitPlanMode, revdiff s'ouvre automatiquement sur le texte du plan. Vous pouvez annoter les parties avec lesquelles vous n'êtes pas d'accord ou que vous souhaitez développer, quitter, et l'agent révise le plan avant d'écrire du code.

Fonctionnalités clés

• TUI à deux volets : arborescence des fichiers à gauche, différences avec coloration syntaxique à droite
• Navigation de style Vim avec recherche (/), saut de blocs et surlignage des changements au niveau des mots
• Marges de responsabilité affichant le nom de l'auteur et l'âge du commit par ligne
• Mode différences réduit affichant le texte final avec marqueurs de changement
• Mode retour à la ligne avec marqueurs de continuation
• Indicateurs de défilement horizontal avec marqueurs « / »
• Numéros de ligne avec marges ancien/nouveau côte à côte pour les différences
• Support Mercurial avec détection automatique et traduction de références de style git
• Détection automatique des fichiers uniques qui masque le volet arborescence pour une vue complète des différences
• Popup de liste d'annotations pour parcourir toutes les annotations entre les fichiers
• Ligne d'état avec nom de fichier, statistiques de différences, position des blocs et indicateurs de mode
• Superposition d'aide affichant tous les raccourcis clavier organisés par section
• Navigation par table des matières Markdown pour les fichiers Markdown uniques
• Mode tous fichiers pour parcourir et annoter tous les fichiers suivis par git
• Examen de fichiers sans git pour les fichiers hors dépôts
• Examen de tampon temporaire pour texte arbitraire redirigé ou pipé
• Historique d'examen sauvegardé automatiquement dans ~/.config/revdiff/history/

Personnalisation

Revdiff propose 7 thèmes de couleurs intégrés, des raccourcis clavier remappables et des remplacements de couleurs par CLI, variables d'environnement ou fichier de configuration. Vous pouvez exporter les raccourcis par défaut avec --dump-keys.

Installation et utilisation

Installez via Homebrew : brew install umputun/apps/revdiff. L'outil est un binaire unique - exécutez simplement revdiff HEAD~3 pour examiner vos 3 derniers commits. Il fonctionne avec les dépôts git et Mercurial.

Support des plugins

Des plugins prêts à l'emploi sont disponibles pour Claude Code (superposition terminal via tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2, ou Emacs vterm), Codex et pi. Le plugin Claude Code nécessite l'un des terminaux pris en charge car Claude Code lui-même ne peut pas afficher d'applications TUI interactives.

Détails techniques

Écrit en Go et open source sous licence MIT. Nécessite git ou hg pour générer des différences (optionnel lors de l'utilisation de --only ou --stdin).