Saltar al contenido principal
El CLI incluye un conjunto de banderas de diagnóstico que están disponibles en cada comando. Son la forma más rápida de entender qué está a punto de enviar el CLI, por qué falló una solicitud o cómo se ven tus credenciales para el gateway.

​
Previsualiza una solicitud con --dry-run

Imprime la solicitud que se enviaría sin contactar la API: 
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --input '"Summariza el día."' \
  --dry-run
La salida de dry-run se escribe en stderr e incluye:
  • Método HTTP y URL.
  • Encabezados de la solicitud (valores sensibles redactados).
  • Una previsualización del cuerpo de la solicitud (campos sensibles redactados).
El comando finaliza correctamente sin ejecutarse. Úsalo para verificar cómo las banderas, --body y la entrada estándar se combinan en el cuerpo final, y para comprobar qué encabezados se adjuntan antes de ejecutar realmente.

​
Rastrear tráfico en vivo con --debug

Ejecuta el comando normalmente y registra el intercambio completo de solicitud/respuesta en stderr: 
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --input '"Summariza el día."' \
  --debug
La salida de debug incluye:
  • Método de solicitud, URL, encabezados y previsualización del cuerpo.
  • Estado de la respuesta, encabezados y previsualización del cuerpo.
  • Errores de transporte (DNS, TLS, timeouts, etc.).
Tu salida estándar habitual no se ve afectada, por lo que puedes combinar --debug con --output-format json o un filtro --jq sin que los dos flujos colisionen: 
mka1 llm models list --debug --jq '.data[].id' 2> debug.log
Si pasas tanto --dry-run como --debug, prevalece --dry-run y no se realiza ninguna llamada de red.

​
Redacción en la salida de diagnóstico

El CLI redacta los secretos que puede detectar antes de imprimirlos:
  • Encabezados — Authorization, Cookie, Set-Cookie, X-API-Key y otros encabezados de seguridad se muestran como [REDACTADO].
  • Cuerpo — Los campos JSON llamados password, secret, token, api_key, client_secret y similares se muestran como [REDACTADO].
Aun así, trata la salida de diagnóstico como datos operativos: sigue revelando URLs de solicitudes, IDs de recursos y otro contexto que un tercero no debería ver.

​
Explora el árbol de comandos

Lanza la interfaz de terminal interactiva para navegar por cada grupo de comandos y ejecutar uno sin salir de la terminal: 
mka1 explore
Úsalo cuando no estés seguro de qué subcomando usar o qué banderas acepta un comando. Puedes filtrar, inspeccionar descripciones y saltar directamente a la ejecución. Cuando quieras una alternativa no interactiva, mka1 --usage imprime el esquema completo de comandos en KDL para que puedas procesarlo automáticamente.

​
Modo agente

--agent-mode cambia los valores predeterminados del CLI para ser más amigables con herramientas de codificación con IA:
  • Los errores se devuelven como objetos estructurados en lugar de prosa libre.
  • El formato de salida predeterminado pasa a ser toon (compacto y eficiente en tokens).
La bandera se habilita automáticamente cuando el CLI detecta un entorno de agente conocido — por ejemplo, cuando se establece CLAUDE_CODE o CURSOR_AGENT. Pasa --agent-mode=false para desactivarlo, o establécelo explícitamente para forzarlo en entornos desconocidos: 
mka1 llm models list --agent-mode

​
Tiempos de espera, servidores personalizados y encabezados extra

Hay algunas banderas heredadas más que vale la pena conocer:
  • --timeout 30s — limita la duración de la solicitud HTTP. Acepta sufijos ms, s o m.
  • --server-url https://custom-api.example.com — sobrescribe completamente la URL base.
  • --server <name|index> — selecciona un servidor nombrado o indexado de la lista interna del CLI.
  • -H 'Header-Name: value' — adjunta un encabezado arbitrario. Repetible.
  • --no-interactive — desactiva cualquier prompt interactivo (auto-prompting, lanzamiento automático del explorador, formularios TUI). Úsalo en CI.
mka1 llm models list \
  --server-url https://custom-api.example.com \
  --timeout 10s \
  -H 'X-Request-Id: audit-42' \
  --no-interactive

​
Receta para resolución de problemas

Cuando un comando se comporta de forma inesperada, este orden suele llevarte a la respuesta más rápido:
  1. Ejecuta con --dry-run para confirmar la URL, encabezados y cuerpo.
  2. Ejecuta mka1 auth whoami para confirmar qué credencial está en uso y de dónde proviene.
  3. Vuelve a ejecutar con --debug 2> debug.log para capturar la solicitud y respuesta completas.
  4. Si la respuesta no es obvia, vuelve a ejecutar con --include-headers --output-format json --jq '.' para que se impriman juntos el payload completo y los encabezados.