Revdiff: Visor de Diferencias en Terminal con Anotaciones en Línea para Agentes de IA

Qué hace Revdiff

Revdiff es una interfaz de usuario de terminal (TUI) para visualizar diferencias diseñada para un flujo de trabajo específico: revisar cambios de código generados por IA sin salir de la sesión de terminal donde se ejecuta el agente de IA. La herramienta permite anotar líneas, fragmentos o archivos y enviar esas anotaciones directamente al agente de IA para su procesamiento.

Flujo de trabajo principal

Desde una sesión de Claude Code, puedes escribir /revdiff main o decir "revisar diferencias de los últimos 3 commits" para abrir revdiff como una superposición de terminal sobre la sesión del agente. Después de leer las diferencias y agregar anotaciones, sales, y las anotaciones van directamente al agente. Cuando el agente termina de hacer cambios, revdiff se vuelve a abrir automáticamente en los nuevos cambios, creando un ciclo continuo hasta que sales sin dejar anotaciones.

Integración de planificación

Un complemento separado revdiff-planning se conecta al modo de planificación de Claude Code. Cuando el agente termina un plan y llama a ExitPlanMode, revdiff se abre automáticamente en el texto del plan. Puedes anotar partes con las que no estás de acuerdo o que quieres expandir, sales, y el agente revisa el plan antes de escribir cualquier código.

Características principales

• TUI de dos paneles: árbol de archivos a la izquierda, diferencias con resaltado de sintaxis a la derecha
• Navegación estilo Vim con /búsqueda, salto entre fragmentos y resaltado de cambios a nivel de palabra
• Márgenes de autoría que muestran nombre del autor y antigüedad del commit por línea
• Modo de diferencias colapsado que muestra texto final con marcadores de cambio
• Modo de ajuste de línea con marcadores de continuación
• Indicadores de desbordamiento de desplazamiento horizontal con marcadores « / »
• Números de línea con márgenes antiguos/nuevos lado a lado para diferencias
• Soporte para Mercurial con detección automática y traducción de referencias estilo git
• Detección automática de archivo único que oculta el panel de árbol para vista de diferencias de ancho completo
• Ventana emergente de lista de anotaciones para navegar todas las anotaciones entre archivos
• Línea de estado con nombre de archivo, estadísticas de diferencias, posición del fragmento e indicadores de modo
• Superposición de ayuda que muestra todos los atajos de teclado organizados por sección
• Navegación por TOC de Markdown para archivos markdown de un solo archivo
• Modo todos los archivos para navegar y anotar todos los archivos rastreados por git
• Revisión de archivos sin git para archivos fuera de repositorios
• Revisión de búfer temporal para texto arbitrario canalizado o redirigido
• Historial de revisiones guardado automáticamente en ~/.config/revdiff/history/

Personalización

Revdiff ofrece 7 temas de color incluidos, atajos de teclado reasignables y anulaciones por color mediante banderas CLI, variables de entorno o archivo de configuración. Puedes exportar los atajos de teclado predeterminados con --dump-keys.

Instalación y uso

Instala mediante Homebrew: brew install umputun/apps/revdiff. La herramienta es un solo binario - solo ejecuta revdiff HEAD~3 para revisar tus últimos 3 commits. Funciona con repositorios git y Mercurial.

Soporte de complementos

Hay complementos listos para usar disponibles para Claude Code (superposición de terminal vía tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2, o Emacs vterm), Codex y pi. El complemento de Claude Code requiere uno de los terminales compatibles ya que Claude Code en sí mismo no puede mostrar aplicaciones TUI interactivas.

Detalles técnicos

Escrito en Go y de código abierto bajo licencia MIT. Requiere git o hg para generar diferencias (opcional cuando se usa --only o --stdin).