Saltar al contenido principal
Esta guía te lleva de cero a un diff revisado en menos de cinco minutos.
1

Instalar

Instala el CLI y despliega los skills de Kodus en todos los agentes de IA detectados (Claude Code, Cursor, Codex, Windsurf):
curl -fsSL https://review-skill.com/install | bash
Requiere Node.js >= 20.0.0.
Verifica la instalación:
kodus --version
kodus status
2

Autenticarse

Elige la opción que se adapte a tu situación. También puedes omitir la autenticación y ejecutar kodus review directamente: funciona en modo de prueba con límites diarios.
Inicia sesión con una cuenta personal:
kodus auth login
Los tokens se almacenan en ~/.kodus/credentials.json y se actualizan automáticamente.
¿Usas Kodus auto-alojado? Apunta el CLI a tu API antes de autenticarte:
export KODUS_API_URL=https://kodus-api.yourcompany.com
Se requiere HTTPS excepto para localhost.
Confirma el estado de autenticación:
kodus auth status
3

Ejecutar tu primera revisión

Dentro de cualquier repositorio git con cambios no confirmados:
kodus review
El CLI analiza el diff de tu árbol de trabajo, imprime un resumen y (en modo interactivo) te permite navegar archivo por archivo, previsualizar las correcciones sugeridas y aplicarlas.Variaciones comunes:
kodus review --staged             # Solo archivos preparados
kodus review --branch main        # Comparar la rama actual contra main
kodus review --commit abc123      # Analizar un solo commit
kodus review --fix                # Aplicar automáticamente todos los problemas corregibles
kodus review --prompt-only        # Salida compacta para agentes de IA
kodus review --fail-on error      # Salir con código distinto de cero en error o superior (apto para CI)
Las revisiones del árbol de trabajo (predeterminado) y --staged incluyen el contenido de los archivos para que el backend vea tus cambios no confirmados. Los modos --branch y --commit omiten la inclusión ya que el backend puede obtener esos commits directamente: por eso esos modos funcionan bien en ramas enormes.
4

Elegir los siguientes pasos

Según tu objetivo:

Automatizar en cada envío

Instala el hook pre-push con kodus hook install.

Ejecutar revisiones en CI

Ejemplos de GitHub Actions, GitLab CI y pipelines genéricos.

Conectar con un agente de IA

Alimenta --prompt-only en Claude Code, Cursor o Codex para bucles de corrección autónomos.

Configurar el repositorio

Gestiona archivos ignorados, ramas base y configuraciones de revisión desde el CLI.

​
Variables de Entorno

Estas variables de entorno configuran el CLI en todos los comandos.
VariableDescripción
KODUS_API_URLEndpoint de la API (predeterminado: https://api.kodus.io)
KODUS_TEAM_KEYClave de equipo para acceso compartido y agentes de IA
KODUS_TOKENToken de CI/CD generado mediante kodus auth token
KODUS_VERBOSEEstablecer en true para salida detallada
KODUS_SKIP_HOOKEstablecer en 1 para omitir el hook pre-push en un solo git push
KODUS_REQUEST_TIMEOUT_MINTiempo de espera por solicitud en minutos (predeterminado: 60)
CF_ACCESS_CLIENT_IDID de cliente de Cloudflare Access (APIs detrás de Zero Trust)
CF_ACCESS_CLIENT_SECRETSecreto de cliente de Cloudflare Access
Para configuraciones auto-alojadas, tokens y Cloudflare Access, consulta Configuración Self-Hosted.

​
Solución de Problemas

¿Encontraste un error? Consulta la guía de Solución de Problemas para síntomas comunes y correcciones.