Translation out of date
The source content changed after this translation. See the Português version. View original
Running without the interface
hinow-cli run: one request, one response, for scripts, CI and automations.
Updated on Sep 16, 2026
hinow-cli run makes a request and prints the response, without the interface. It's the way to use the agent in scripts, in CI and anywhere a screen doesn't make sense.
hinow-cli run "Liste os endpoints definidos em src/api e diga quais não têm teste."The output shows the tools used and the response. With --format json, each event comes out as a JSON line, for another program to consume:
hinow-cli run --format json "Quantos arquivos .ts existem em src?" | jq -r 'select(.type=="text") | .part.text'| Option | What it does |
|---|---|
--dir <folder> | Runs in another folder, without cd |
-f, --file <file> | Attaches files to the request (can repeat) |
-m, --model | Model, in the format provider/model (default: hinow/hicode) |
--variant | Reasoning level: low, medium or high |
--agent | Agent to use (yours are in ~/.config/hinow/agents) |
-c, --continue / -s, --session <id> | Continues the last session, or a specific one |
--title | Session title |
--auto | Auto-approves what is not denied in the configuration. Only in controlled environments |
--machine <name> / --remote-dir <folder> | Runs on another machine of yours via HINOW Connect. See [Using from elsewhere](/en/cli/remote/use) |
--attach <url> | Uses a hinow-cli serve already running instead of starting its own server |
# 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."Approvals without interface
Without the interface, a permission request is denied (the command does not run) and the response follows. Use --auto only when the machine and request are trusted, or configure permissions by default in ~/.config/hinow/hinow.json.