Comandos y opciones

​

Índice de comandos

​

Referencia de comandos

​

raigal scan

raigal scan [opciones] [ruta]

• --changes: analiza únicamente los archivos modificados respecto a git HEAD.
• --staged: analiza únicamente los archivos preparados en git stage (ideal para pre-commit).
• --base <ref>: compara contra una rama o referencia específica (ejemplo: origin/main).
• -d, --verbose: muestra el desglose de archivos y líneas por regla.
• --json: devuelve el árbol completo de diagnósticos en JSON.
• --sarif: genera un informe en formato estándar OASIS SARIF 2.1.0.
• --exclude <patrones>: lista de rutas a ignorar separadas por coma o repetidas.
• --include <patrones>: lista de rutas a incluir expresamente.
• --fail-on <nivel>: devuelve código 1 según la gravedad mínima: none, error o warning.

​

raigal ci

raigal ci [opciones] [ruta]

• Devuelve código de salida 1 si se detecta cualquier error o si la puntuación es menor que ci.failBelow (por defecto: 70).
• --changes: evalúa únicamente los archivos modificados respecto a --base (o HEAD).
• --staged: evalúa únicamente los archivos en stage.
• --base <ref>: referencia base para calcular el diff de --changes (ejemplo: origin/main).
• --human: muestra un resumen legible en la consola de CI en lugar de JSON crudo.
• --sarif: emite informe SARIF 2.1.0 por stdout para anotaciones en GitHub Code Scanning (ejemplo: raigal ci --sarif > resultados.sarif).
• --format <formato>: formato de salida: json (por defecto) o sarif.

​

raigal fix

raigal fix [opciones] [ruta]

• --safe: aplica únicamente cambios deterministas que no alteran el comportamiento del código (por defecto).
• -f, --force: ejecuta correcciones más amplias, como actualización de dependencias y limpieza profunda.
• --dry-run: previsualiza qué cambiaría sin tocar los archivos en disco.
• -p, --prompt: convierte los problemas no corregibles automáticamente en un prompt para tu asistente de código.
• --changes / --staged: limita las correcciones a archivos modificados o en stage.
• --base <ref>: referencia base para calcular los cambios.

​

raigal agent

raigal agent [opciones] [ruta]

• --provider <proveedor>: proveedor a invocar (auto, codex, claude, opencode).
• --target <n>: nota mínima objetivo a alcanzar (por defecto: 90).
• --max-turns <n>: número máximo de turnos del agente por intento (por defecto: 5).
• --max-cost <usd>: tope de gasto en dólares que interrumpe la sesión si el consumo de tokens supera el límite.
• --limit <n>: número máximo de incidencias que se envían al agente (por defecto: 8).
• --in-place: modifica directamente el árbol de trabajo actual en lugar de crear un worktree aislado.
• --apply: aplica los cambios aceptados a tu rama actual al terminar.
• -y, --yes: omite preguntas de confirmación al usar --apply.
• --dry-run: muestra el plan de ejecución y el proveedor seleccionado sin aplicar cambios.
• --background: arranca el agente en segundo plano y devuelve el control al terminal de inmediato.
• --no-fix: omite los arreglos automáticos seguros previos antes de llamar al agente.
• --commit: crea un commit con los cambios verificados en una rama de reparación.
• --pr: publica la rama y abre un pull request en GitHub.
• --branch <nombre>: nombre de la rama para --commit o --pr.
• --base <rama>: rama base de destino para el pull request.
• --title <titulo>: título del pull request.
• --commit-message <mensaje>: mensaje del commit.
• --ready: abre el pull request como listo para revisión en lugar de borrador (draft).
• --cleanup: elimina el worktree temporal incluso si quedan cambios sin guardar.

• raigal agent plan [dir]: previsualiza proveedor, worktree y acciones sin modificar archivos.
• raigal agent connect [proveedor]: conecta con un proveedor local mediante su propia sesión de terminal.
• raigal agent providers: lista los proveedores de agentes detectados en el sistema y su estado.
• raigal agent use [proveedor]: define o consulta el proveedor predeterminado para este proyecto.
• raigal agent sessions [dir]: lista las sesiones de reparación activas y anteriores.
• raigal agent show <session-id>: muestra los cambios y diagnósticos de una sesión concreta.
• raigal agent apply <session-id>: fusiona los cambios de una sesión en tu rama de trabajo.
• raigal agent monitor [dir]: vigila cambios en git y analiza el código en segundo plano (añade --auto-fix para permitir ediciones automáticas).

​

raigal hook

raigal hook <subcomando>

• raigal hook install [agentes...]: instala los hooks de intercepción (ejemplo: raigal hook install --claude).
• raigal hook status: comprueba los hooks instalados y la integridad de los centinelas SHA-256.
• raigal hook baseline: captura la deuda técnica actual en .raigal/baseline.json.
• raigal hook uninstall [agentes...]: desinstala los hooks limpiamente sin alterar la configuración del editor.

​

raigal report-pr-closed

raigal report-pr-closed [--pr <numero>] [--merged]

• --pr <numero>: número del pull request (se lee automáticamente de GITHUB_EVENT_PATH en GitHub Actions).
• --merged: indica si el pull request se fusionó en la rama base.

​

raigal login y raigal logout

# Inicio de sesión interactivo con navegador
raigal login

# Inicio de sesión pasando el token por stdin
echo "rgl_live_..." | raigal login --with-token

# Cerrar sesión y limpiar credenciales locales
raigal logout

​

raigal whoami

raigal whoami

​

raigal doctor

raigal doctor

​

raigal rules

raigal rules