CLI — rodar e conversar
A CLI okami é organizada por domínio. Sem argumento, okami mostra a visão geral agrupada; okami <comando> --help traz as flags. Toda configuração interativa é por m…
Convenções e flags globais
-p, --providere-m, --modelaparecem emrun/task/chat— sobrescrevem o default dookami.yaml.-a, --agentroda COMO um agente (agents/<id>); sem ele, usa o agente default do setup.-w, --workspacedefine o diretório de trabalho (default varia por comando).-y, --yoloauto-aprova ações sensíveis só naquela sessão.okami --version/-Vimprime a versão e sai.
Códigos de saída
| código | significa |
|---|---|
| 0 | sucesso (task: estado COMPLETE) |
| 1 | erro de execução / config inválida |
| 2 | task não-COMPLETE (BLOCKED/NEEDS_INPUT/FAILED) ou gate/scan reprovado |
okami setup
Assistente de configuração (providers, login, memória, identidade, canal). Fork Rápido (detecta o que você já tem) vs Completo no primeiro prompt. okami setup <seção> pula direto.
params [section] arg Pula pra uma seção: provider · memory · agent · channel · voice · approvals · learning · persona. --memory fts5|holographic|holographic+honcho Atalho não-interativo: só escreve o bloco de memória. --honcho-url / --honcho-key string Endpoint/credencial do Honcho (com --memory holographic+honcho). --embedder-url / --embedder-model string Servidor e modelo de embedding (OpenAI-compat).
okami run
Uma ida-e-volta CRUA ao provider — sem sessão, sem harness. Pra testar um prompt ou usar em pipe.
params <prompt> arg O prompt para o modelo (obrigatório). -p, --provider string Provider a usar (default: do okami.yaml). -m, --model string Sobrescreve o model do provider. -s, --system string System prompt opcional. --no-stream flag Desliga o streaming (devolve a resposta completa de uma vez).
okami task
Roda o harness até COMPLETE/BLOCKED/NEEDS_INPUT/FAILED. É o ponto de entrada verificável — ideal para CI, cron e scripts. Sem objetivo, ele pergunta.
params [goal] arg Objetivo da tarefa. Vazio → pergunta (ou erra em pipe). -e, --exit crit (repetível) Critério de saída verificado: file_exists, file_contains, shell_ok, ui_gate. --max-steps int Teto de passos do harness. 24 --escalate provider Provider forte p/ a cascata se travar. --mode manual|smart|off Modo de aprovação só nesta execução. -y, --yes / --yolo flag Auto-aprova tudo na sessão. -a / -p / -m / -w — Agente · provider · modelo · workspace (default workspaces/default).
okami task "adicione um teste para parse_date" \
-e "shell_ok:pytest -q tests/test_dates.py"okami chat
Conversa no terminal. Por padrão abre a TUI de tela cheia (regiões fixas, mouse, scroll, aprovação por botão); a sessão persiste e retoma ao reabrir. Com uma mensagem como argumento, faz one-shot (script/pipe).
params [message] arg Mensagem única (one-shot). Vazio → REPL/TUI interativo. --tui / --no-tui flag TUI de tela cheia (default) ou REPL de linha. tui --new flag Começa do zero (arquiva a conversa anterior do terminal). -y, --yolo flag Auto-aprova ações sensíveis nesta sessão. -a / -p / -m / -w — Agente · provider · modelo · workspace.
okami room
Brainstorm multi-agente: um moderador barato decide quem fala (ou ninguém), sem stampede. Os grupos vêm de groups: no okami.yaml.
params <message> arg Mensagem ao grupo (use @id para mencionar e forçar resposta). -g, --group int Índice do grupo em okami.yaml (groups). 0 --moderator provider Provider barato p/ o moderador escolher o orador.