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

```sh
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

```sh
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

```sh
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

```sh
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.