Argumentos de la CLI
Todos los flags, tipos, valores y límites del ejecutable.
Comal 0.1.0 · Revisado el 15 oct 2026
En esta página
Inventario contrastado con Comal 0.1.0, el 2026-10-16. Las referencias de código señalan el punto inspeccionado, no disponibilidad garantizada de servicios externos.
Uso general
node bin/comal.mjs [opciones] [prompt]
node bin/comal.mjs --help
Los flags no conceden permisos implícitos salvo que su contrato lo indique. Los placeholders ID, UUID, PERFIL y rutas se sustituyen por valores reales.
Todos los argumentos
| Argumento | Tipo | Predeterminado | Uso y límites | Fuente |
|---|---|---|---|---|
--print / -p |
boolean | false |
Ejecuta un turno y termina (también acepta stdin) Sin terminal se activa también; stdin si falta prompt, máximo 1 MiB. | src/cli.mjs:138 |
--help / -h |
boolean | false |
Muestra esta ayuda Ayuda sin modelo. | src/cli.mjs:138 |
--version / -v |
boolean | false |
Muestra versión Comal 0.1.0. | src/cli.mjs:138 |
--demo |
boolean | false |
Demo determinista sin credenciales; permite sus ediciones Guion determinista sin credenciales; acceptEdits por defecto; no subagentes. | src/cli.mjs:139 |
--cwd |
string | process.cwd() |
Workspace (por defecto: directorio actual) Debe existir y se resuelve realpath. | src/cli.mjs:139 |
--model |
string | autodescubrimiento local |
Modelo; por defecto descubre el local en /v1/models ID exacto del catálogo; Anthropic fallback claude-sonnet-4-6; Gemini directo gemini-2.5-flash. | src/cli.mjs:139 |
--base-url |
string | http://llama.local:11438/ |
Endpoint; por defecto http://llama.local:11438/ Varía según protocolo/perfil/login. | src/cli.mjs:139 |
--provider |
string | openai |
openai (predeterminado) | anthropic | gemini openai|anthropic|gemini; gemini explícito o perfil. | src/cli.mjs:139 |
--profile |
string | null |
Perfil de .comal/providers.json (endpoint/modelo/capacidades) Nombre de perfil; COMAL_PROFILE o perfil persistido/defaultProfile. | src/cli.mjs:140 |
--providers-config |
string | .comal/providers.json |
Archivo de perfiles; claves sólo vía apiKeyEnv O COMAL_PROVIDERS_CONFIG. JSON versión 1. | src/cli.mjs:140 |
--name |
string | null |
Nombre visible a otras sesiones Nombre persistido de sesión de 1–120 caracteres, distinto al perfil de proveedor. | src/cli.mjs:140 |
--listen |
boolean | false |
Mantiene el CLI escuchando mensajes y responde al quedar idle Necesario en CLI no interactivo para seguir recibiendo; TUI escucha automáticamente. | src/cli.mjs:140 |
--inbound |
string | accept |
accept (predeterminado) | hold | refuse accept|hold|refuse; estado persistido de sesión puede restaurarse. | src/cli.mjs:140 |
--permission-mode |
string | default |
default | acceptEdits | plan | auto default|acceptEdits|plan|auto; --demo usa acceptEdits. | src/cli.mjs:141 |
--allowed-tools |
string | [] |
Autoriza nombres separados por comas Nombres separados por coma o espacio; no anulan denegación ni gobernanza. | src/cli.mjs:141 |
--disallowed-tools |
string | [] |
Deniega nombres; prevalece sobre autorización Denegación prevalece. | src/cli.mjs:141 |
--resume |
string | null |
Reanuda una sesión de este workspace UUID de este workspace, excluye --continue; hijos sólo vía padre. | src/cli.mjs:142 |
--continue / -c |
boolean | false |
Reanuda la sesión más reciente Última sesión del workspace. | src/cli.mjs:142 |
--output-format |
string | text |
text | json | stream-json (con --print) text|json|stream-json; sólo modo print. | src/cli.mjs:142 |
--max-turns |
string | 12 |
Llamadas antes de extender trabajo con progreso (12) Entero 1–100; llamadas del tramo, no operaciones; no acepta unlimited/0. | src/cli.mjs:143 |
--work-max-calls |
string | 80 |
Límite total con continuación de tareas (80; 0 desactiva) Entero 0–10000; 0 DESACTIVA continuación automática, no significa ilimitado. | src/cli.mjs:143 |
--system-prompt |
string | null |
Instrucciones adicionales Instrucciones iniciales personalizadas, junto con contexto e instrucciones de workspace. | src/cli.mjs:143 |
--state-dir |
string | .comal/ |
Ubicación del estado; por defecto .comal/ (reutiliza .harness/ existente) Reutiliza .harness/ si ya existe y no existe .comal/; explícito se resuelve desde cwd del proceso. | src/cli.mjs:143 |
--context-window |
string | auto; fallback 45000 |
Límite explícito; automático según modelo, fallback 45000 Entero 4096–2000000; flag > entorno. Sin límite explícito sigue los metadatos; con límite aplica el menor anunciado/configurado. Se reserva salida y margen. | src/cli.mjs:144 |
--max-tokens |
string | 8192 |
Máximo inicial de tokens de salida (8192) Entero 64–mitad de context-window; reserva salida, no tamaño del contexto. | src/cli.mjs:144 |
--thinking |
string | auto |
auto | on | off | low | medium | high (llama.cpp) auto|on|off|low|medium|high; compatibilidad llama.cpp; effort explícito lo sustituye. | src/cli.mjs:144 |
--vision |
string | auto |
auto | on | off (auto consulta /props al recibir imágenes) auto|on|off; on es configuración del usuario, no prueba observada. | src/cli.mjs:144 |
--image-tokens |
string | 4096 |
Reserva estimada por imagen (4096, máximo 2 imágenes) Entero 256–32768, reserva estimada por imagen. | src/cli.mjs:144 |
--effort |
string | auto |
auto | off | minimal | low | medium | high | xhigh | max (si el modelo lo admite) auto|off|minimal|low|medium|high|xhigh|max; niveles no-auto requieren anuncio del modelo. | src/cli.mjs:146 |
--auth-provider |
string | null |
Login de Comal: codex | kimi | minimax | grok codex|kimi|minimax|grok; selecciona transporte y origen de login. | src/cli.mjs:146 |
--api-key-env |
string | null |
Login: comal login PROVEEDOR [--api-key-env VARIABLE] · comal auth status [PROVEEDOR] · comal logout PROVEEDOR Sólo nombre de variable para login; no pasar el valor de clave. | src/cli.mjs:146 |
--model-timeout-ms |
string | 600000 |
Tiempo total de cada respuesta OpenAI (600000) Entero 1–3600000, tiempo total de respuesta del adaptador OpenAI. | src/cli.mjs:147 |
--model-idle-timeout-ms |
string | 180000 |
Tiempo sin progreso de tokens OpenAI (180000) Entero 1–3600000, tiempo sin progreso de tokens del adaptador OpenAI. | src/cli.mjs:147 |
--mcp-config |
string | .mcp.json |
Conecta MCP stdio, Streamable HTTP o SSE de un JSON JSON mcpServers; --mcp-config explícito se resuelve desde cwd del proceso. | src/cli.mjs:148 |
--trust-mcp |
boolean | false |
Autoriza conexiones iniciales; cambios se revisan de nuevo Confianza conexiones iniciales solamente; cambios posteriores se juzgan aparte. | src/cli.mjs:148 |
--plugin-config |
string | .comal/plugins.json |
Plugins Node locales (JSON); por defecto .comal/plugins.json O COMAL_PLUGIN_CONFIG; sigue state-dir/compatibilidad .harness. | src/cli.mjs:149 |
--trust-plugins |
boolean | false |
Autoriza cargar código local de la config inicial Confianza para ejecutar código local de configuración inicial. | src/cli.mjs:149 |
--chrome-task |
string | null |
Tarea Chrome explícita; la casa coordina publicación, checks y cierre Encargo inmutable por sesión, ruta desde --cwd. Reanudación desde el stream. Requiere chrome-lab activo y conserva sus permisos. | src/cli.mjs:149 |
--goal |
string | null |
Ejecuta un objetivo hasta verificación o límite Condición humana 1–4000 caracteres; no se combina con prompt posicional. | src/cli.mjs:150 |
--goal-max-turns |
string | 20 |
Máximo de turnos del objetivo (20) Entero 1–10000, iteraciones de GoalRunner. | src/cli.mjs:150 |
--goal-max-calls |
string | 80 |
Llamadas totales: agente + verificadores (80) Entero 1–10000; agente+clasificador+verificador+subagentes comparten presupuesto. | src/cli.mjs:150 |
--goal-max-tokens |
string | 100000 |
Presupuesto de tokens del objetivo (100000) Entero 1–10000000; reserva entrada/salida completa, sin encoger respuesta al agotarse. | src/cli.mjs:150 |
--cloud-url |
string | COMAL_CLOUD_ORIGIN o https://comal.milpahq.com |
Origen HTTPS de tu cuenta Comal; separado del proveedor de inferencia. Fija el origen de las credenciales; no sigue redirects ni envía tokens a otro host. | src/cli.mjs:145 |
--manifest |
string | Sin valor |
Archivo JSON con metadata de comal artifacts publish. workspace_id, session_id, title, entrypoint, checks opcionales y artifact_id/base_version para updates. No contiene claves. | src/cli.mjs:145 |
Comandos fuera de la TUI
| Comando | Fuente |
|---|---|
node bin/comal.mjs sessions |
src/cli.mjs:172 |
node bin/comal.mjs evidence |
src/cli.mjs:166 |
node bin/comal.mjs audit --resume UUID | audit --continue |
src/cli.mjs:167 |
node bin/comal.mjs providers |
src/cli.mjs:156 |
node bin/comal.mjs peers |
src/cli.mjs:159 |
node bin/comal.mjs message DESTINO TEXTO |
src/cli.mjs:160 |
node bin/comal.mjs login PROVEEDOR [--api-key-env VARIABLE] |
src/cli.mjs:145 |
node bin/comal.mjs logout PROVEEDOR |
src/cli.mjs:145 |
node bin/comal.mjs auth status [PROVEEDOR] |
src/cli.mjs:145 |
node bin/comal.mjs cloud login|status|logout [--cloud-url ORIGEN] |
src/cli.mjs:154 |
node bin/comal.mjs artifacts list |
src/cli.mjs:162 |
node bin/comal.mjs artifacts inspect ID |
src/cli.mjs:162 |
node bin/comal.mjs artifacts publish DIRECTORIO --manifest METADATA.json |
src/cli.mjs:162 |
node bin/comal.mjs artifacts verify ID |
src/cli.mjs:162 |
node bin/comal.mjs artifacts release ID VERSION JOB |
src/cli.mjs:162 |
Presupuestos que no son intercambiables
--max-turns: tramo inicial, 1–100. --work-max-calls: extensión con progreso; 0 la desactiva. /goal: presupuestos compartidos para agente y comprobación. No existe un valor ilimitado implementado. Consulta trabajo largo.
Ver esta página como Markdown
Fuente editable de esta guía: referencia-cli.md. Las páginas de referencia se regeneran desde el inventario auditado.