Primeros Pasos

Esta guía te lleva de cero a un diff revisado en menos de cinco minutos.

Instalar

Instalador de Skills (Recomendado)
npm
npx (Sin Instalación)
curl

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

npm install -g @kodus/cli

npx @kodus/cli review

curl -fsSL https://raw.githubusercontent.com/kodustech/cli/main/install.sh | bash

Requiere Node.js >= 20.0.0.

Verifica la instalación:

kodus --version
kodus status

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.

Desarrollador individual
Equipo (clave compartida)
Agente de IA
CI/CD

Inicia sesión con una cuenta personal:

kodus auth login

Los tokens se almacenan en ~/.kodus/credentials.json y se actualizan automáticamente.

Genera una clave de equipo en app.kodus.io/organization/cli-keys y aplícala:

kodus auth team-key --key kodus_xxxxx

O distribuye el comando de inicio a tu equipo: instala el CLI y configura la clave de una sola vez:

curl -fsSL https://review-skill.com/install | bash -s -- --team-key kodus_xxxxx

Guarda la clave cuando se muestre — no se volverá a mostrar.

Para agentes de programación de IA (Claude Code, Cursor, Codex), las claves de equipo son la opción recomendada: sin inicio de sesión individual, sin indicaciones interactivas. Establece la clave una sola vez:

export KODUS_TEAM_KEY=kodus_xxxxx

Agrégala a tu perfil de shell para que el agente la recoja en cada ejecución.

Desde una máquina con sesión iniciada, genera un token de larga duración:

kodus auth token

En tu pipeline, establece:

export KODUS_TOKEN=<generated-token>

Consulta Configuración Self-Hosted para ver ejemplos completos de CI.

¿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

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.

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.

Variable	Descripción
`KODUS_API_URL`	Endpoint de la API (predeterminado: `https://api.kodus.io`)
`KODUS_TEAM_KEY`	Clave de equipo para acceso compartido y agentes de IA
`KODUS_TOKEN`	Token de CI/CD generado mediante `kodus auth token`
`KODUS_VERBOSE`	Establecer en `true` para salida detallada
`KODUS_SKIP_HOOK`	Establecer en `1` para omitir el hook pre-push en un solo `git push`
`KODUS_REQUEST_TIMEOUT_MIN`	Tiempo de espera por solicitud en minutos (predeterminado: `60`)
`CF_ACCESS_CLIENT_ID`	ID de cliente de Cloudflare Access (APIs detrás de Zero Trust)
`CF_ACCESS_CLIENT_SECRET`	Secreto 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.

Comenzando

Facturación y Licencias

Revisión de Código con IA

CLI

Cockpit

Kody Issues

Organización

Seguridad

Solución de Problemas

Primeros Pasos

Automatizar en cada envío

Ejecutar revisiones en CI

Conectar con un agente de IA

Configurar el repositorio

Variables de Entorno

Solución de Problemas

Automatizar en cada envío

Ejecutar revisiones en CI

Conectar con un agente de IA

Configurar el repositorio

​Variables de Entorno

​Solución de Problemas

Variables de Entorno

Solución de Problemas