coding.sh doctor
Check agents, hooks, spool, store and the OTLP port. Every option of coding.sh doctor, from its own --help.
coding.sh doctor [options]
Check agents, hooks, spool, store and the OTLP port
Options
-a, --agent <AGENT> Only this agent (repeatable, or a comma list: a,b)
--port <PORT> OTLP receiver port to check (default: 4318)
--conformance Instead: read each agent's transcripts and check the events against coding.sh's invariants (read-only)
--since <WHEN> With --conformance, only transcripts after this time: 7d, 12h, 30m or a date (local time) (default: 7d)
--max-events <N> With --conformance, stop each agent after this many events (default: 200000)
Examples
coding.sh doctor
coding.sh doctor --json
coding.sh doctor --conformance
Notes
A row marked ! is a warning, and --json lists each one under warnings with the command that fixes it. An agent is one when no hook for this coding.sh home is in its config or something blocks the hook; the last line then reads N agents not capturing. The exit code and ok in --json are 1 and false only when the spool or the store fails.
--conformance runs each agent's backfill over the transcripts on this machine and checks the events: ids, timestamps, tool and subagent pairing, parent links, usage and prompts. It only reads: blobs are hashed and dropped, SQLite sources are read from a copy, and the coding.sh store is not opened. Exits 1 when any agent has a violation.