Processos em background e PTY
Além de run_shell, o Okami tem tools e CLI para comandos longos: servidor dev, watcher, teste demorado ou processo interativo. O processo fica registrado em disco,…
Quando usar
- Servidor que precisa ficar de pé enquanto o agente navega/testa.
- Build/teste longo que não deve bloquear todo o turno.
- REPL ou comando interativo que precisa receber stdin depois.
- Watch com padrões de log (
Listening on,ERROR) e notificação quando terminar.
Tools
params process_start tool inicia comando em background; aceita notify, watch, interactive process_write tool envia stdin para processo interativo process_poll tool status + saída recente process_wait tool espera terminar até um timeout process_log tool log completo ou paginado (offset/limit) process_list tool lista processos conhecidos process_signal tool TERM/INT/HUP/KILL/USR1/USR2/CONT/STOP/QUIT process_kill tool mata processo/grupo
Supervisão pelo terminal
okami ps -w workspaces/defaultlista processos do workspace padrãookami processsem subcomando também lista processosokami process log <id> -n 200 -fmostra ou segue log redigidookami process kill <id>envia TERM para o grupo ou docker kill quando isoladookami process signal <id> INTenvia sinal arbitráriookami process wait <id> -t 60espera terminar e mostra exit codeokami process clean --ttl-hours 24 --dry-runmostra o que seria podado além do TTLokami ps -a uiusa o workspace do agente agents/uiComo isso fecha o gap
O agente pode iniciar um servidor ou watcher via tool e continuar trabalhando. Fora do gateway ou TUI, uma pessoa ainda consegue listar, ler logs, esperar, sinalizar ou matar o processo pelo okami process, sem depender da sessão original.
Política de segurança
Processos longos usam o mesmo SandboxPolicy do run_shell. Em read-only, process_start é bloqueado; em modo normal, comandos que tocam .env, .ssh, .aws, credenciais, .pem ou .key são bloqueados salvo perfil yolo.
Retenção e limpeza
Metadados e logs ficam em .okami/processes. retention.processes.ttl_hours controla limpeza de processos terminados; rode okami clean --deep para aplicar.