Pular para o conteúdo principal
Todo comando suporta --output-format para controlar como os resultados são exibidos no stdout:
FormatoFlagQuando usar
Pretty--output-format pretty (padrão)Para ler a saída em um terminal. Pares chave-valor alinhados com cor e indentação aninhada.
JSON--output-format jsonPara scripts, uso com jq, salvar em arquivo. Mantém a ordem original dos campos e precisão numérica quando a resposta já é JSON.
YAML--output-format yamlSaída semelhante a configuração, fácil de comparar visualmente.
Table--output-format tableRespostas em array onde cada item tem o mesmo formato — ex: llm models list.
TOON--output-format toonToken-Oriented Object Notation. Compacto, orientado a linhas, 30–60% menos tokens que JSON — ideal para uso em prompts de LLM.
# Padrão legível para humanos
mka1 llm models list

# JSON legível por máquina
mka1 llm models list --output-format json

# TOON compacto para passar para outro LLM
mka1 llm responses get --response-id resp_123 --output-format toon

​
Filtrar e transformar com jq

Use --jq para filtrar ou remodelar respostas inline com uma expressão jq. Isso sempre gera JSON e sobrescreve --output-format: 
# Extrair um único campo
mka1 llm models list --jq '.data[].id'

# Filtrar um array
mka1 llm responses list --jq '.data[] | select(.status == "completed")'

# Remodelar em um novo objeto
mka1 llm files list --jq '.data[] | {id, name: .filename, bytes}'
Como --jq imprime JSON puro, ele se integra bem com shells e outras chamadas de CLI: 
mka1 llm files upload --file ./doc.pdf --purpose assistants --jq '.id' \
  | xargs -I {} mka1 llm vector-stores create-file --vector-store-id vs_123 --file-id {}

​
Paginação e streaming

Algumas operações retornam muitos itens ou eventos enviados pelo servidor. A saída é escrita incrementalmente conforme cada item chega:
FormatoComportamento de streaming
jsonUm objeto JSON compacto por linha (NDJSON)
yamlDocumentos YAML separados por ---
toonUm objeto codificado em TOON por bloco, separados por linhas em branco
pretty (padrão)Itens formatados separados por linhas em branco

​
Paginar por uma coleção

Passe --all em comandos de listagem para seguir automaticamente o cursor next e emitir cada página conforme ela chega: 
mka1 llm responses list --all --output-format json > responses.ndjson

​
Fazer streaming de eventos enviados pelo servidor

Operações de streaming (por exemplo, llm responses create --stream) emitem um evento por linha: 
mka1 llm responses create \
  --model meetkai:functionary-pt \
  --input '"Escreva três tópicos de notas de lançamento."' \
  --stream \
  --output-format json

# Manter apenas os deltas de texto
mka1 llm responses create \
  --model meetkai:functionary-pt \
  --input '"Escreva três tópicos de notas de lançamento."' \
  --stream \
  --jq 'select(.type == "response.output_text.delta") | .delta'
Pressione Ctrl+C para parar de consumir um stream antes do fim.

​
Cor

--color controla as cores do terminal para o formato pretty:
ValorComportamento
auto (padrão)Usa cor quando stdout é um TTY, texto puro caso contrário.
alwaysSempre usa cor.
neverNunca usa cor.
O CLI também respeita as variáveis de ambiente amplamente utilizadas NO_COLOR e FORCE_COLOR.

​
Incluir cabeçalhos da resposta

Use --include-headers quando precisar dos cabeçalhos HTTP da resposta junto com o corpo — por exemplo, para ler um ID de requisição para suporte ou inspecionar um cabeçalho de limite de taxa: 
mka1 llm models list --include-headers

​
Escrever respostas binárias em um arquivo

Comandos que retornam dados binários (como llm speech speak) suportam --output-file para escrever o corpo em um caminho sem poluir o stdout: 
mka1 llm speech speak \
  --text 'Olá, bem-vindo ao nosso serviço.' \
  --output-file ./welcome.wav
Use --output-b64 quando precisar embutir o payload binário em um pipeline de JSON ou texto.

​
Códigos de saída

Código de saídaSignificado
0Sucesso. Resposta escrita no stdout.
1Erro. Detalhes escritos no stderr.
Isso torna o fluxo de controle estilo if simples em scripts: 
if ! mka1 llm responses get --response-id resp_123 > out.json 2> err.log; then
  echo "Falha na requisição — veja err.log"
  exit 1
fi
Veja debug e inspeção para --dry-run e --debug, que oferecem mais visibilidade sobre por que um comando falhou.