Ir para o conteúdo

Rodar sem a interface

hinow-cli run: um pedido, uma resposta, para scripts, CI e automações.

Atualizado em 16 de set. de 2026

hinow-cli run faz um pedido e imprime a resposta, sem a interface. É o jeito de usar o agente em scripts, em CI e em qualquer lugar onde uma tela não faz sentido.

hinow-cli run "Liste os endpoints definidos em src/api e diga quais não têm teste."

A saída mostra as ferramentas usadas e a resposta. Com --format json, cada evento sai como uma linha JSON, para outro programa consumir:

hinow-cli run --format json "Quantos arquivos .ts existem em src?" | jq -r 'select(.type=="text") | .part.text'

Opções mais usadas

OpçãoO que faz
--dir <pasta>Roda em outra pasta, sem cd
-f, --file <arquivo>Anexa arquivos ao pedido (pode repetir)
-m, --modelModelo, no formato provedor/modelo (padrão: hinow/hinow/hicode)
--variantNível de raciocínio: low, medium ou high
--agentAgente principal a usar (plan, ou um seu). Subagentes se chamam com @nome no pedido
--command <nome>Roda um comando com barra: os seus, init, review, uma skill ou um prompt MCP. O pedido vira os argumentos
--thinkingMostra os blocos de raciocínio na saída
-c, --continue / -s, --session <id>Continua a última sessão, ou uma específica
--titleTítulo da sessão
--autoAprova sozinho o que não está negado na configuração. Sem ele, tudo que **perguntaria** é recusado e o pedido para com erro; só em ambientes controlados
--machine <nome> / --remote-dir <pasta>Roda em outra máquina sua pelo HINOW Connect. Veja [Usar de outro lugar](/pt/cli/remote/use)
--attach <url>Usa um hinow-cli serve já em execução em vez de subir um servidor próprio

Exemplos

# revisão num pipeline
hinow-cli run --variant high -f CHANGELOG.md "Revise o diff da branch atual contra main e aponte riscos."

# continuar de onde parou
hinow-cli run -c "Agora escreva os testes do que você mudou."

# em outra máquina sua
hinow-cli run --machine servidor-01 --remote-dir /srv/loja "Rode os testes e me diga o que falhou."

Aprovações sem tela

Sem a interface, um pedido de permissão é recusado (o comando não roda) e a resposta segue. Use --auto só quando a máquina e o pedido são de confiança, ou configure permissões por padrão em ~/.config/hinow/hinow.json.