// operação · 02

Observabilidade e diagnóstico

Cada turno deixa rastro. O events.jsonl registra tool-calls, loops e compaction; a trajetória reconstrói o turno passo a passo; e o okami doctor é o seu raio-X de c…

doctor

O primeiro comando quando algo não vai bem. Checa providers, chaves, conectividade, toolchain (git, uv, node, docker, claude), SQLite FTS5, embedder e sandbox.

okami doctordiagnóstico legível
okami doctor --fixconserta lock órfão, perms do .env, temporários
okami doctor --jsonrelatório estruturado (monitoramento/CI)
okami doctor --lintlint de postura (pass/warn/fail)

status e usage

okami status mostra a visão resolvida — agente, modelo, providers, memória, aprovação, persona, voz, auto-skill — com tokens e custo acumulados da sessão. Dentro do chat, /usage faz o mesmo para a conversa atual.

events e replay

okami events é a timeline da última task (replay/debug). okami replay lista os turnos recentes; okami replay <trace> reconstrói a trajetória completa de um turno — passos, chamadas LLM, tokens in/out e o desfecho.

okami events -n 40        # últimos 40 eventos da task
okami replay             # lista os turnos (trace, passos, tokens, desfecho)
okami replay <trace>     # trajetória completa de um turno

tune e clean

okami tune mostra as stats por modelo que alimentam o auto-tune do capability profile. okami clean faz faxina de disco (locks órfãos, temporários, áudio); --deep aplica quota a sessões arquivadas e checkpoints.

Abrir esta página nos docs interativos