Comal desde scripts

El modo headless permite integrar Comal en un proceso que necesita una salida concreta. Define permisos y presupuesto antes de iniciar.

Un turno con JSON

node bin/comal.mjs --permission-mode plan --max-turns 4 \
  --output-format json -p 'Inspecciona este proyecto y devuelve un diagnóstico sin modificar archivos'

--print ejecuta un turno y termina, salvo que elijas --listen. Sin terminal interactiva no se puede pedir autorización: las operaciones sin permiso se rechazan.

Streaming de eventos

node bin/comal.mjs --output-format stream-json -p 'Explica este módulo'

Lee eventos como JSON por línea, conserva session_id y comprueba is_error en el resultado. No interpretes un fragmento de texto o un argumento parcial como una herramienta ya autorizada.

Recuperar una sesión

node bin/comal.mjs sessions
node bin/comal.mjs --resume UUID -p 'Continúa desde el estado registrado'
node bin/comal.mjs audit --resume UUID

Añade --providers-config cuando la sesión use un perfil de ese archivo. El libro conserva modelo/esfuerzo y referencias de conexión; las credenciales actuales se resuelven aparte.

Escuchar otra instancia

node bin/comal.mjs -p --profile PERFIL --name trabajador --listen

Usa la configuración de perfiles correspondiente. --listen mantiene el CLI abierto para mensajes. No supone que cualquier mensaje pueda cambiar permisos, login o instrucciones de la casa.

Práctica

Captura un resultado JSON, conserva el UUID y consulta su auditoría. Distingue fallos de transporte, ejecución y comprobación del objetivo antes de reintentar un comando con efectos.