Observability and diagnostics
Every turn leaves a trail. events.jsonl records tool-calls, loops and compaction; the trajectory reconstructs a turn step by step; and okami doctor is your X-ray of…
doctor
The first command when something's off. It checks providers, keys, connectivity, the toolchain (git, uv, node, docker, claude), SQLite FTS5, the embedder and the sandbox.
okami doctorhuman-readable diagnosisokami doctor --fixrepair stale locks, .env perms, temp filesokami doctor --jsonstructured report (monitoring/CI)okami doctor --lintposture lint (pass/warn/fail)status and usage
okami status shows the resolved view — agent, model, providers, memory, approval, persona, voice, auto-skill — with accumulated session tokens and cost. Inside chat, /usage does the same for the current conversation.
events and replay
okami events is the timeline of the last task (replay/debug). okami replay lists recent turns; okami replay <trace> reconstructs a turn's full trajectory — steps, LLM calls, tokens in/out and the outcome.
okami events -n 40 # last 40 task events
okami replay # list turns (trace, steps, tokens, outcome)
okami replay <trace> # full trajectory of a turntune and clean
okami tune shows the per-model stats that feed the capability-profile auto-tune. okami clean does disk cleanup (stale locks, temp files, audio); --deep applies a quota to archived sessions and checkpoints.