difit: interfaz web local para revisar diffs de Git con generación de prompts para IAArtículo · digest del 1 de noviembre
Interfaz de revisión de código en dos columnas en la pantalla oscura de un portátil con líneas del diff resaltadas y botón de exportación de prompt para agente de programación
Artículo4 secciones≈ 9 min

difit: interfaz web local para revisar diffs de Git con generación de prompts para IA

Con la llegada de agentes de programación autónomos como Claude Code, Cursor y Aider, el ritmo habitual de desarrollo ha cambiado: las redes neuronales reescriben decenas de archivos en un par de minutos, modifican firmas de funciones y rehacen módulos enteros. Pero en cuanto llega el momento de verificar qué es exactamente lo que hizo el agente, el desarrollador se topa con un muro.

El git diff estándar en la terminal se convierte en una sopa interminable de líneas verdes y rojas. Los colores se mezclan, las líneas largas se parten de forma horrible según el ancho de la consola y comparar el código «antes» y «después» lado a lado resulta prácticamente imposible. El impulso más natural en ese momento es hacer push de la rama a GitHub, abrir un Pull Request en borrador y revisar con calma los cambios en una interfaz web limpia.

Pero enseguida surge un conflicto serio de seguridad y sentido común. Subir código crudo, posiblemente roto o con tokens privados a servidores externos en la nube de la empresa es simplemente arriesgado. Además, generar decenas de commits basura en el repositorio remoto solo para visualizar cambios es un placer dudoso. El desarrollador conocido como yoshiko-pg propuso una solución de ingeniería elegante para este dolor de cabeza al publicar la utilidad de código abierto yoshiko-pg/difit. Se trata de una herramienta local ligera que con un solo comando despliega en tu computadora una interfaz web completa de code review al estilo GitHub, sin enviar ni un solo paquete de red al exterior.

Bajo el capó: arquitectura del inspector local

En difit me conquistó de inmediato la limpieza de su implementación técnica. En lugar de intentar empaquetar el proyecto en un pesado Electron de medio gigabyte de memoria, el autor armó un tándem compacto de Node.js y una aplicación de una sola página ligera.

Todo el conjunto se lanza mediante la utilidad Commander.js, que valida los argumentos de la línea de comandos y levanta un servidor HTTP local basado en Express. El servidor se enlaza exclusivamente a la interfaz local 127.0.0.1 en un puerto libre aleatorio (o en el puerto indicado con la bandera --port). Para extraer los datos de Git, la herramienta usa la probada librería simple-git, que invoca el binario git en el contexto de tu repositorio.

La parte cliente está construida en React 18 con Vite, y el estilo visual reproduce casi al píxel el tema oscuro GitHub Dark Mode sobre Tailwind CSS v4. Del resaltado de sintaxis se encarga el motor ligero Prism.js con carga dinámica de gramáticas: sin importar si tu agente edita TypeScript, Rust, Go, Python, C++, SQL o plantillas de Terraform, las líneas se resaltan al instante y sin retrasos.

# Inicio instantáneo de la inspección de todos los cambios sin confirmar (índice + directorio de trabajo)
npx difit .

# Vista previa solo de los archivos en staging, listos para el commit
npx difit staged

# Comparación de la rama de trabajo actual con la rama objetivo main
npx difit main...HEAD

# Revisión de un commit específico por su hash
npx difit 7a3b1c9

Al iniciarse, la utilidad abre automáticamente el navegador predeterminado. Obtienes el conocido árbol de archivos en dos columnas a la izquierda y un área central con cambio entre los modos Split (lado a lado) y Unified (línea por línea), colapso de archivos ya revisados y conteo de líneas añadidas y eliminadas.

Puente hacia los modelos de lenguaje: de comentarios a prompts

Sin embargo, si difit fuera solo otra herramienta local para ver diffs, difícilmente merecería tanta atención. El verdadero superpoder de la utilidad se revela en cómo se integra en el flujo de trabajo con inteligencia artificial.

Imagina un escenario típico: el agente escribió la implementación de un método, pero falló al manejar un caso borde u olvidó cerrar la conexión a la base de datos. En la terminal tienes que copiar a mano el nombre del archivo, recordar los números exactos de línea y redactar el contexto para el chat con el modelo. En difit este proceso está llevado al automatismo.

Al pasar el cursor sobre cualquier línea del diff (tanto en la versión antigua como en la nueva), puedes pulsar el botón para añadir un comentario o seleccionar con el ratón todo un rango de líneas. En el campo de texto que aparece escribes la observación en lenguaje humano normal — por ejemplo: «Aquí hace falta añadir una comprobación de nil antes de desreferenciar el puntero y devolver el error ErrNotFound».

Junto al botón de guardar comentario, difit ofrece dos funciones clave:

  • Copy Prompt: copia al portapapeles una captura estructurada de esa observación concreta, con la ruta relativa al archivo, el rango de líneas y tu comentario incluidos automáticamente;
  • Copy All Prompt: reúne absolutamente todas las observaciones dejadas en la sesión actual de revisión entre distintos archivos y genera un listado único y estructurado de correcciones listo para pasárselo a Claude Code, Cursor o Aider.
{
  "task": "review_feedback",
  "files": [
    {
      "path": "internal/service/user.go",
      "lines": "L45-L52",
      "issue": "Falta comprobación de expiración de timeout del contexto antes de llamar a la API externa",
      "fix": "Añadir un select con ctx.Done() y devolver ctx.Err()"
    },
    {
      "path": "internal/repository/postgres.go",
      "lines": "L118-L124",
      "issue": "Posible fuga de conexiones en el pool: rows.Close() debe llamarse mediante defer",
      "fix": "Envolver el cierre de la consulta en defer rows.Close() justo después de comprobar err"
    }
  ]
}

difit guarda cuidadosamente todos los comentarios en el almacenamiento local del navegador (localStorage), vinculándolos al hash del commit actual o al nombre de la rama. Incluso si cierras por error la pestaña del navegador o reinicias el servidor en la terminal, tu progreso y observaciones no se perderán.

Automatización mediante Agent Skills y pipelines de CLI

Otra faceta de ingeniería interesante de difit es la posibilidad de convertirlo en una habilidad autónoma (Agent Skill) para los propios asistentes de IA. Soporta la especificación abierta de skills, gracias a la cual el agente puede inicializar por sí mismo una sesión de revisión e invitar al humano a una inspección interactiva.

# Instalación de las skills de difit en el entorno de trabajo del agente de programación
npx skills add yoshiko-pg/difit

Tras añadir la skill, el agente obtiene acceso a dos manifiestos programáticos: difit y difit-review. Cuando el modelo termina una refactorización a gran escala, puede no limitarse a mostrar un informe seco en la terminal, sino ejecutar el comando de difit en segundo plano y enviar al desarrollador el enlace al panel local. La persona marca los puntos dudosos, pulsa «Copy All Prompt», pega el resultado de vuelta en la conversación y el agente procede a corregir las observaciones en una segunda iteración.

Este enfoque complementa muy bien a sistemas multiagente de gestión de sesiones de trabajo como la utilidad codeg, de la que hablamos anteriormente: mientras codeg aísla las consolas de agentes en paralelo, difit asume el papel de pantalla única de verificación de código.

Es más, la utilidad soporta trabajar con el flujo de entrada estándar (stdin). Esto permite usar difit en cualquier pipeline de Unix:

# Inspección de un parche arbitrario mediante la entrada estándar
git diff --cached | npx difit -

# Comparación de dos archivos arbitrarios en disco con la utilidad del sistema diff
diff -u old_config.yaml new_config.yaml | npx difit

Y si aun así necesitas inspeccionar un Pull Request remoto de un colega en GitHub, la bandera --pr <url> utiliza el GitHub CLI (gh) instalado en el sistema, descarga el parche mediante gh pr diff y trae los hilos de discusión existentes directamente a la ventana local.

Dónde están los límites y qué conviene tener en cuenta

Como toda herramienta práctica, difit tiene sus particularidades arquitectónicas que conviene considerar antes de integrarlo en el flujo de trabajo diario.

En primer lugar, la herramienta está diseñada para repositorios de tamaño moderado y medio. Si tu agente de programación generó un diff colosal con cambios en varios cientos de miles de líneas (por ejemplo, si tocó por error bundles compilados o archivos generados de esquema GraphQL), el parseo inicial del payload JSON en el cliente puede provocar una congelación temporal de la pestaña del navegador. Para esos casos, en difit se recomienda pasar explícitamente una máscara de rutas — por ejemplo, npx difit . -- "src/**/*.ts".

En segundo lugar, recuerda el aislamiento del almacenamiento: como las observaciones se guardan en localStorage, quedan vinculadas a un navegador concreto en tu máquina. No podrás compartir una sesión de revisión con un colega por la red local sin exportar manualmente el prompt, ya que el servidor escucha únicamente en la dirección de loopback 127.0.0.1 por seguridad de tu código fuente.

En resumen, estamos ante un excelente ejemplo de utilidad práctica de nueva ola: en lugar de suites en la nube sobrecargadas, el autor ofreció a los ingenieros una herramienta rápida, autónoma y segura que ahorra horas de tiempo al trabajar con los omnipresentes agentes de programación.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2