git-lrc

git-lrc: Revisiones de Código con IA Gratuitas e Ilimitadas en cada Commit

En la era actual del desarrollo de software, la IA generativa actúa como un coche de carreras sin frenos. Aunque herramientas como Cursor, Windsurf o Copilot permiten acelerar la creación de bloques de código de forma instantánea, también introducen riesgos significativos. Los agentes de IA pueden romper la lógica de forma silenciosa, eliminar restricciones, introducir llamadas costosas a la nube o filtrar credenciales sin previo aviso.

git-lrc nace como la solución definitiva a estos problemas, funcionando como el sistema de frenado necesario para tu flujo de trabajo. Es una herramienta que se integra en los git hooks para ejecutar una revisión de IA en cada diff antes de que se consolide en tu repositorio.

¿Qué es git-lrc?

git-lrc es una herramienta de código abierto (source-available) diseñada para realizar revisiones de código automáticas impulsadas por Inteligencia Artificial. A diferencia de otros servicios costosos, git-lrc utiliza la API de Google Gemini, permitiendo revisiones ilimitadas sin costo alguno para el usuario, ya que tú mismo proporcionas tu propia clave de API.

El objetivo principal de git-lrc es capturar problemas críticos antes de que el código sea enviado a producción. Al integrarse directamente con Git, asegura que ningún cambio pase desapercibido, convirtiendo la revisión en un hábito obligatorio y fluido dentro del ciclo de desarrollo.

Características Principales de git-lrc

1. Revisiones Automáticas en el Commit

Al configurar git-lrc, la herramienta se activa automáticamente cada vez que ejecutas git commit. Analiza los cambios preparados (staged) y lanza una interfaz de revisión en tu navegador.

2. Detección Inteligente de Errores

git-lrc está entrenado para identificar problemas que a menudo escapan al ojo humano tras una generación masiva de código por IA:

• Fugas de credenciales: Identifica claves API o contraseñas expuestas.
• Lógica eliminada silenciosamente: Detecta cuándo la IA ha quitado código esencial sin aviso.
• Datos sensibles en logs: Evita que información privada termine en los registros del sistema.
• Operaciones costosas: Alerta sobre llamadas a la nube que podrían disparar los costos.

3. Interfaz de Usuario Estilo GitHub

La interfaz de revisión de git-lrc ofrece una experiencia rica y detallada:

• Diff en color: Adiciones y eliminaciones claras.
• Comentarios en línea de IA: Observaciones precisas en las líneas exactas que importan.
• Insignias de severidad: Identificación visual de la gravedad de cada hallazgo.
• Resumen de cambios: Visión de alto nivel y estadísticas de líneas modificadas.

4. Seguimiento en el Log de Git

Cada commit revisado con git-lrc incluye información de seguimiento en el mensaje del log, detallando el número de iteraciones y la cobertura de la revisión (por ejemplo: LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)).

Cómo usar git-lrc

La implementación de git-lrc es extremadamente sencilla y rápida, diseñada para estar lista en menos de un minuto.

Instalación

Para sistemas macOS o Linux, ejecuta el siguiente comando en tu terminal:

curl -fsSL https://hexmos.com/lrc-install.sh | sudo bash

Configuración Inicial

Una vez instalado, ejecuta el comando de configuración:

git lrc setup

Este proceso te guiará para obtener dos claves necesarias:

1. LiveReview API key: Iniciando sesión con Hexmos.
2. Gemini API key: Obtenida gratuitamente desde Google AI Studio.

Flujo de Trabajo Diario

Existen dos formas principales de interactuar con git-lrc:

Opción A: Revisión Automática

1. Realiza tus cambios y añádelos: git add .
2. Intenta hacer el commit: git commit -m "tu mensaje"
3. La revisión de git-lrc se lanzará automáticamente en tu navegador.

Opción B: Revisión Manual

Si prefieres revisar antes de intentar el commit:

1. git add .
2. git lrc review (Ejecuta la revisión de IA).
3. Tras corregir, puedes usar git lrc review --vouch para indicar que te haces responsable del código, o git lrc review --skip para omitir.

Casos de Uso

git-lrc es ideal para diversos perfiles y situaciones dentro del desarrollo de software:

• Desarrolladores que usan Agentes de IA: Si utilizas Cursor, Windsurf o Copilot, git-lrc actúa como el revisor humano que verifica que la IA no haya introducido errores sutiles.
• Equipos que buscan robustez: Ayuda a construir el hábito de revisar cada cambio, reduciendo el número de bugs que llegan a la rama principal.
• Control de seguridad: Es una barrera esencial para evitar que secretos o credenciales se suban accidentalmente al repositorio.
• Auditoría de cambios: Gracias al rastreo en el log de git, los líderes de equipo pueden ver qué commits fueron revisados exhaustivamente por la IA.

Referencia de Comandos Rápidos

| Comando | Descripción | | :--- | :--- | | lrc review | Revisa los cambios preparados (staged). | | lrc review --vouch | Omite la IA y asume responsabilidad personal. | | lrc review --skip | Omite la revisión para el commit actual. | | lrc review --commit HEAD | Revisa un cambio que ya ha sido confirmado. | | lrc hooks disable | Desactiva los hooks en el repositorio actual. | | lrc hooks enable | Reactiva los hooks en el repositorio actual. | | lrc self-update | Actualiza a la última versión disponible. |

FAQ (Preguntas Frecuentes)

¿Qué datos se envían para el análisis?

Solo se analiza el diff de los archivos preparados (staged). No se carga el contexto completo del repositorio y los diffs no se almacenan después de la revisión.

¿Por qué es gratuito?

git-lrc utiliza la API de Google Gemini, que ofrece un nivel gratuito generoso. Al traer tu propia clave de API, no hay intermediarios en la facturación. El servicio de coordinación LiveReview también es gratuito para revisiones ilimitadas.

¿Puedo desactivarlo para un repositorio específico?

Sí, puedes usar el comando git lrc hooks disable dentro de cualquier repositorio donde no desees que se ejecute la revisión automática.

¿Funciona con cualquier editor?

Sí. Dado que funciona a nivel de Git, es compatible con cualquier editor, IDE o herramienta de IA que utilice Git para la gestión de versiones.

Conclusión: Si la IA es tu acelerador, git-lrc es tu sistema de frenos indispensable. Instálalo hoy y asegura la calidad de cada commit de forma automática y gratuita.