// guias · cookbook

Recipes executáveis

Receitas que podem ser copiadas para um terminal e deixam evidência verificável. Cada uma tem objetivo, comando, critério de sucesso e onde olhar se falhar.

Abrir na documentação completa GitHub

Criar uma task com exitCriteria

okami task "crie hello.txt com a palavra oi" \
  -e file_exists:hello.txt \
  -e "file_contains:hello.txt:oi"
okami events -n 20

sucesso	evidência
exit code 0	`COMPLETE` no events.jsonl
arquivo criado	`hello.txt` existe e contém `oi`
auditoria	tool `write_file` em `.okami/audit.jsonl`

Aplicar UI gate

okami task "crie uma tela de login com shadcn" -e ui_gate
okami gate -c ui ./src

Use esta receita quando quiser provar que a skill guiou a implementação e que o contrato hard barrou CSS cru, hex inline ou imports fora da fonte definida.

Subir API HTTP local

okami config set OKAMI_API_TOKEN <token-forte>
okami serve --host 127.0.0.1 --port 8765
curl -s http://127.0.0.1:8765/health
curl -s http://127.0.0.1:8765/chat \
  -H 'Authorization: Bearer <token-forte>' \
  -H 'content-type: application/json' \
  -d '{"agent":"okami","message":"diga oi"}'

Supervisionar processo fora do agente

okami task "suba o servidor de desenvolvimento e me diga a porta" \
  -e "shell_ok:curl -fsS http://127.0.0.1:3000"
okami ps -w workspaces/default
okami process log <id> -n 80
okami process signal <id> INT
okami process clean --ttl-hours 24 --dry-run

Criar agente Telegram

okami agent new suporte --name "Suporte" --telegram-token $TELEGRAM_TOKEN
okami route telegram:<chat-id>
okami gateway --foreground

Configurar MCP

okami mcp
okami tools
okami task "liste os repositórios disponíveis no MCP configurado"

Rodar Paperclip heartbeat

export PAPERCLIP_API_URL=https://paperclip.example.com
export PAPERCLIP_API_KEY=<token>
export PAPERCLIP_RUN_ID=<run-id>
okami paperclip
okami heartbeat --mode defer

Sala multi-agente

okami room "planejem uma migração de auth para produção" -g 0
okami chat
/agents

Abrir esta página nos docs interativos