---
title: "coding.sh doctor · coding.sh docs"
description: "Check agents, hooks, spool, store and the OTLP port. Every option of coding.sh doctor, from its own --help."
canonical: https://coding.sh/docs/cli/doctor
human_url: https://coding.sh/docs/cli/doctor
markdown_url: https://coding.sh/docs/cli/doctor.md
agents_url: https://coding.sh/agents.md
llms_url: https://coding.sh/llms.txt
updated: 2026-11-11
---

# 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 --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.
```

[All commands](https://coding.sh/docs/cli) · [Global options](https://coding.sh/docs/cli#global)

To set coding.sh up for a user, follow the agent workflow at [/agents.md](https://coding.sh/agents.md).