Referencia de Comandos

Flags Globales

Estos flags están disponibles en todos los comandos:

Flag	Corto	Predeterminado	Descripción
`--format <fmt>`	`-f`	`terminal`	Formato de salida: `terminal`, `json`, `markdown`
`--output <file>`	`-o`	—	Guardar la salida en un archivo
`--verbose`	`-v`	`false`	Salida detallada
`--quiet`	`-q`	`false`	Modo silencioso (solo errores)
`--agent`	—	`false`	Modo agente: salida determinista legible por máquina

`kodus review`

Analiza los archivos modificados en busca de problemas de calidad de código, errores, vulnerabilidades de seguridad e infracciones de estilo.

Uso

kodus review                          # Revisar cambios del árbol de trabajo (interactivo)
kodus review [files...]               # Revisar archivos específicos
kodus review --staged                 # Revisar solo archivos preparados
kodus review --branch main            # Comparar contra una rama
kodus review --commit abc123          # Analizar un commit específico
kodus review --fix                    # Aplicar automáticamente todos los problemas corregibles
kodus review --prompt-only            # Salida optimizada para agentes de IA

Flags

Flag	Corto	Descripción
`--staged`	`-s`	Analizar solo archivos preparados
`--commit <sha>`	`-c`	Analizar el diff de un commit específico
`--branch <name>`	`-b`	Comparar la rama actual contra la rama especificada
`--rules-only`	—	Revisar usando solo las reglas configuradas (sin sugerencias generales)
`--fast`	—	Modo rápido: análisis más ágil con verificaciones más ligeras
`--focus <text>`	—	Dirige la revisión a un área específica — consulta Dirigir una Revisión
`--heavy`	—	Pasada más profunda: rondas extra de crítico para mayor recall (alpha, ver abajo)
`--interactive`	`-i`	Modo interactivo: navegar y aplicar correcciones
`--fix`	—	Aplicar automáticamente todos los problemas corregibles
`--prompt-only`	—	Salida optimizada para agentes de IA
`--fail-on <severity>`	—	Salir con código 1 si los problemas alcanzan o superan la severidad
`--context <file>`	—	Archivo de contexto personalizado para incluir en la revisión
`--fields <csv>`	—	Seleccionar campos de respuesta (modo JSON/agente), p. ej. `summary,issues.file`
`--github-pat <token>`	—	Token de GitHub (`read:repo`) usado para clonar repositorios privados. Solo usuarios en trial. También vía `KODUS_GITHUB_PAT`. Se mantiene solo en memoria, nunca se persiste.
`--no-hunk`	—	Omite el visor hunk y usa la lista interactiva antigua (solo sesiones interactivas)

--heavy es una función alpha, con acceso bajo petición — está desactivada para todas las organizaciones hasta que la habilitemos. Solo cloud por ahora; no disponible en self-hosted. Hasta que te habilitemos, la flag se acepta pero la revisión se ejecuta con normalidad, sin error ni aviso. Solicita acceso en Discord o en support@kodus.io. Consulta Heavy mode.

Modos de Revisión

Interactivo (Predeterminado)
Corrección Automática
Agente de IA

Navega por archivos con recuentos de problemas, previsualiza las correcciones sugeridas y aplícalas una a una.

kodus review

Aplica todos los problemas corregibles a la vez con una confirmación.

kodus review --fix

Salida mínima y estructurada diseñada para Claude Code, Cursor o Windsurf. Permite bucles autónomos de revisión y corrección.

kodus review --prompt-only

`kodus pr suggestions`

Obtiene sugerencias con IA para pull requests abiertos.

Uso

kodus pr suggestions --pr-url https://github.com/org/repo/pull/42
kodus pr suggestions --pr-number 42 --repo-id <id>
kodus pr suggestions --pr-number 42 --repo-id <id> --severity error,warning
kodus pr suggestions --pr-number 42 --repo-id <id> --format json

Flags

Flag	Descripción
`--pr-url <url>`	URL del pull request
`--pr-number <number>`	Número del pull request (requiere `--repo-id`)
`--repo-id <id>`	ID del repositorio para el pull request
`--severity <list>`	Severidades separadas por comas para incluir
`--category <list>`	Categorías separadas por comas para incluir
`--fields <csv>`	Seleccionar campos de respuesta (modo JSON/agente), p. ej. `summary,issues.file`

`kodus pr business-validation`

Valida un diff local contra las reglas de negocio/criterios de aceptación de una tarea. Útil antes de fusionar para confirmar que la implementación coincide con la intención de la tarea.

Uso

kodus pr business-validation --task-url https://linear.app/team/issue/KC-1441
kodus pr business-validation --task-id KC-1441 --staged
kodus pr business-validation --task-id KC-1441 --branch main
kodus pr business-validation --task-id KC-1441 --commit abc123
kodus pr business-validation --task-id KC-1441 --dry-run

Flags

Flag	Corto	Descripción
`--task-url <url>`	—	URL de la tarea para agregar al comando de validación
`--task-id <id>`	—	ID de tarea o clave de issue (p. ej. `KC-1441`) para agregar
`--staged`	`-s`	Usar solo los cambios preparados
`--commit <sha>`	`-c`	Usar el diff de un commit específico
`--branch <name>`	`-b`	Comparar la rama actual contra una rama base
`--dry-run`	—	Mostrar el payload sin ejecutar la llamada a la API

`kodus auth`

Gestiona la autenticación con la API de Kodus.

kodus auth login                              # Inicio de sesión interactivo
kodus auth login -e user@mail.com -p password # No interactivo

Flag	Corto	Descripción
`--email <email>`	`-e`	Correo de la cuenta
`--password <password>`	`-p`	Contraseña de la cuenta

`auth logout`

kodus auth logout

Elimina la autenticación local (inicio de sesión y clave de equipo).

`auth status`

kodus auth status

Muestra el modo de autenticación, el correo, la validez del token, las organizaciones, el estado de prueba y los límites de uso.

`auth team-key`

kodus auth team-key --key kodus_xxxxx

Autenticar usando una clave de API de equipo compartida. También se puede establecer mediante la variable de entorno KODUS_TEAM_KEY.

`auth team-status`

kodus auth team-status

Muestra los detalles de autenticación del equipo (nombre de la organización y del equipo).

`auth token`

kodus auth token

Genera un token de CI/CD para usar en pipelines automatizados. Úsalo con la variable de entorno KODUS_TOKEN.

`kodus hook`

Gestiona los hooks de Git pre-push para la revisión automática de código antes de enviar cambios.

`hook install`

kodus hook install                    # Predeterminado: fail-on critical, modo rápido habilitado
kodus hook install --fail-on error    # Bloquear envíos con severidad error
kodus hook install --no-fast          # Deshabilitar modo rápido
kodus hook install --force            # Sobrescribir hook existente

Flag	Predeterminado	Descripción
`--fail-on <severity>`	`critical`	Severidad mínima para bloquear el envío
`--fast` / `--no-fast`	`true`	Habilitar/deshabilitar modo rápido
`--force`	—	Sobrescribir hook existente sin preguntar

`hook uninstall`

kodus hook uninstall

Elimina el hook pre-push instalado por Kodus.

`hook status`

kodus hook status

Muestra el estado del hook, la severidad de fail-on, la configuración del modo rápido y la ruta.

Omitir el Hook

KODUS_SKIP_HOOK=1 git push

`kodus config centralized`

Gestiona la configuración centralizada desde el CLI.

Uso

kodus config centralized status
kodus config centralized init [owner/repo] --sync-option <pr|manual>
kodus config centralized sync
kodus config centralized disable
kodus config centralized download --out ./centralized-config.zip

Subcomandos

Subcomando	Descripción
`status`	Mostrar si la configuración centralizada está habilitada y el repositorio fuente seleccionado
`init [repository]`	Habilitar la configuración centralizada para un repositorio seleccionado
`sync`	Ejecutar la sincronización de configuración centralizada bajo demanda
`disable`	Deshabilitar la configuración centralizada y limpiar el repositorio seleccionado
`download --out <path>`	Descargar el bundle ZIP de configuración centralizada

Flags

Flag	Aplica a	Descripción
`--sync-option <pr \| manual>`	`init`	Estrategia de sincronización. El predeterminado es `pr`
`--out <path>`	`download`	Ruta de salida requerida para el archivo ZIP
`--json`	todos los subcomandos centralizados	Salida JSON estructurada

Para una guía completa, consulta: /how_to_use/en/code_review/configs/centralized_config#cli-dedicated-section

`kodus config repo`

Inspecciona y actualiza la configuración del repositorio almacenada en Kodus. Se requiere autenticación con clave de equipo. Usa . para apuntar al repositorio actual.

kodus config repo y kodus config remote son alias del mismo grupo de comandos.

Uso

kodus config repo add                                   # Agregar el repo actual a Kodus
kodus config repo add owner/repo                        # Agregar un repo específico
kodus config repo list                                  # Listar repos configurados
kodus config repo show                                  # Mostrar la configuración del repo actual
kodus config repo setup                                 # Asistente de configuración guiado
kodus config repo set . reviewEnabled true              # Establecer una configuración directamente
kodus config repo open                                  # Abrir el panel de Kodus
kodus config repo add-ignore-file . "**/*.generated.ts"
kodus config repo add-base-branch . "release/*"
kodus config repo add-ignore-title . "^WIP:"

Subcomandos

Subcomando	Descripción
`add [repository]`	Agregar un repositorio a Kodus (atajo: `kodus config -r [repository]`)
`list`	Listar repositorios configurados en Kodus
`show [repository]`	Mostrar la configuración del repositorio
`setup [repository]`	Ejecutar un asistente de configuración guiado del repositorio
`set [repository] <key> <value>`	Establecer una configuración del repositorio directamente
`open [repository]`	Abrir el panel de Kodus para configuraciones avanzadas
`add-pattern [repository] <field> <pattern>`	Agregar un patrón a un campo de lista (`ignore-files`, `base-branches`, `ignore-titles`)
`remove-pattern [repository] <field> <pattern>`	Eliminar un patrón de un campo de lista
`add-ignore-file [repository] <pattern>`	Atajo: agregar un patrón a los patrones de archivos ignorados
`remove-ignore-file [repository] <pattern>`	Atajo: eliminar un patrón de archivos ignorados
`add-base-branch [repository] <pattern>`	Atajo: agregar un patrón de rama base
`remove-base-branch [repository] <pattern>`	Atajo: eliminar un patrón de rama base
`add-ignore-title [repository] <pattern>`	Atajo: agregar un patrón de título ignorado
`remove-ignore-title [repository] <pattern>`	Atajo: eliminar un patrón de título ignorado

Flags

Flag	Aplica a	Descripción
`--no-prompt`	`add`	Omitir el aviso de configuración posterior a la adición

`kodus rules`

Crea, actualiza y visualiza Kody Rules — reglas estructuradas que Kodus aplica durante la revisión.

Uso

kodus rules view                                         # Ver todas las reglas de tu equipo
kodus rules view --repo-id <id>                          # Filtrar por repositorio
kodus rules view --uuid <rule-uuid>                      # Obtener una regla individual
kodus rules create --title "No console.log" --rule "Avoid leaving console.log in committed code" --severity high
kodus rules update --uuid <rule-uuid> --severity critical

Subcomandos

Subcomando	Descripción
`create`	Crear una nueva Kody Rule
`update`	Actualizar una regla existente
`view`	Ver Kody Rules

Flags de `rules create`

Flag	Predeterminado	Descripción
`--title <title>`	—	Título de la regla
`--rule <rule>`	—	Contenido/descripción de la regla
`--repo-id <id>`	`global`	ID del repositorio (o `global` para aplicar a todos los repos)
`--severity <severity>`	`medium`	`low`, `medium`, `high`, `critical`
`--scope <scope>`	`file`	`pull request` o `file`
`--path <glob>`	`*/`	Patrón glob para la selección de archivos
`--json`	`false`	Mostrar la regla creada como JSON

Flags de `rules update`

Flag	Descripción
`--uuid <uuid>`	UUID de la regla a actualizar (requerido)
`--repo-id <id>`	ID de repositorio actualizado
`--title <title>`	Título actualizado
`--rule <rule>`	Contenido/descripción actualizado
`--severity <severity>`	Severidad actualizada
`--scope <scope>`	Ámbito actualizado
`--path <glob>`	Patrón glob actualizado
`--json`	Mostrar la regla actualizada como JSON

Flags de `rules view`

Flag	Descripción
`--uuid <uuid>`	Obtener una regla individual por UUID
`--repo-id <id>`	Filtrar reglas por ID de repositorio
`--json`	Mostrar las reglas como JSON

`kodus skills`

Inspecciona e instala los skills de agentes incluidos con el CLI (Claude Code, Cursor, Codex).

Uso

kodus skills list                                        # Listar los skills incluidos
kodus skills install                                     # Instalar en los directorios de agentes detectados
kodus skills install --dry-run                           # Vista previa de los cambios
kodus skills resync                                      # Resincronizar los skills incluidos
kodus skills uninstall                                   # Eliminar los skills incluidos

Subcomandos

Subcomando	Descripción
`list`	Listar los skills incluidos disponibles en este paquete del CLI
`sync`	Sincronizar los skills incluidos en los directorios de agentes locales detectados
`resync`	Resincronizar los skills incluidos en los directorios de agentes locales detectados
`install`	Instalar los skills incluidos en los directorios raíz de agentes detectados (crea dirs según sea necesario)
`uninstall`	Desinstalar los skills gestionados incluidos de los directorios de agentes detectados

Flags

Flag	Aplica a	Descripción
`--dry-run`	`install`, `sync`, `resync`, `uninstall`	Mostrar los cambios planificados sin escribir archivos

Para el bootstrap completo de múltiples agentes, prefiere el instalador de plataforma (curl -fsSL https://review-skill.com/install | bash). kodus skills cubre la resincronización local y la limpieza.

`kodus status`

Muestra un estado consolidado de Kodus: modo de autenticación, organización, repositorio, hook, skills incluidos y versión del CLI.

kodus status

Útil como primer diagnóstico cuando algo falla o al incorporar una nueva máquina.

`kodus diff`

Abre el changeset actual en el visor de diff de Hunk en la terminal.

kodus diff

Es un wrapper fino sobre hunk diff — cada argumento que pases se reenvía sin cambios, así que cualquier flag que Hunk soporte también funciona aquí.

Útil para revisar visualmente un changeset antes de ejecutar kodus review sobre él. El mismo visor respalda la experiencia de revisión interactiva; pasa --no-hunk a kodus review si prefieres la lista antigua.

`kodus update`

Actualiza el CLI de Kodus a la última versión desde npm.

kodus update

Resuelve el comando de instalación global correcto para tu gestor de paquetes (npm, yarn, pnpm, bun) y lo ejecuta. Si se usó un script instalador, el CLI te indica el comando para volver a ejecutarlo.

Abre la página de precios/actualización de Kodus en tu navegador.

kodus subscribe

Niveles de Severidad

Los problemas se categorizan por severidad, de mayor a menor:

Nivel	Descripción
`critical`	Problemas graves de seguridad o estabilidad que requieren atención inmediata
`error`	Errores o problemas significativos
`warning`	Problemas potenciales que vale la pena abordar
`info`	Sugerencias y mejores prácticas

Categorías de Problemas

Categoría	Descripción
`security_vulnerability`	Problemas relacionados con la seguridad
`bug`	Posibles errores
`performance`	Oportunidades de optimización del rendimiento
`code_quality`	Mejoras en la calidad del código
`best_practices`	Infracciones de mejores prácticas
`complexity`	Problemas de complejidad del código
`maintainability`	Preocupaciones de mantenibilidad
`style`	Problemas de estilo de código
`documentation`	Carencias de documentación (aceptado por `--category` en `kodus pr suggestions`)

​Flags Globales

​kodus review

​Uso

​Flags

​Modos de Revisión

​kodus pr suggestions

​Uso

​Flags

​kodus pr business-validation

​Uso

​Flags

​kodus auth

​auth login

​auth logout

​auth status

​auth team-key

​auth team-status

​auth token

​kodus hook

​hook install

​hook uninstall

​hook status

​Omitir el Hook

​kodus config centralized

​Uso

​Subcomandos

​Flags

​kodus config repo

​Uso

​Subcomandos

​Flags

​kodus rules

​Uso

​Subcomandos

​Flags de rules create

​Flags de rules update

​Flags de rules view

​kodus skills

​Uso

​Subcomandos

​Flags

​kodus status

​kodus diff

​kodus update

​kodus subscribe

​Niveles de Severidad

​Categorías de Problemas

Flags Globales

`kodus review`

Uso

Flags

Modos de Revisión

`kodus pr suggestions`

Uso

Flags

`kodus pr business-validation`

Uso

Flags

`kodus auth`

`auth login`

`auth logout`

`auth status`

`auth team-key`

`auth team-status`

`auth token`

`kodus hook`

`hook install`

`hook uninstall`

`hook status`

Omitir el Hook

`kodus config centralized`

Uso

Subcomandos

Flags

`kodus config repo`

Uso

Subcomandos

Flags

`kodus rules`

Uso

Subcomandos

Flags de `rules create`

Flags de `rules update`

Flags de `rules view`

`kodus skills`

Uso

Subcomandos

Flags

`kodus status`

`kodus diff`

`kodus update`

`kodus subscribe`

Niveles de Severidad

Categorías de Problemas