CLI ReferenceDoctor
Doctor
Reference for coven doctor output and the readiness checks it performs before running harness sessions.
1 min read
coven doctor is the first command to run after install and the first command to run when something feels broken.
coven doctorIt checks the local state directory, project detection, daemon/socket status, and supported harness CLIs.
What it checks
| Area | What to look for |
|---|---|
| Store | The path Coven will use for local state. Defaults to ~/.coven unless COVEN_HOME is set. |
| Project | Whether the current directory resolves to a git/project root. |
| Daemon | Whether the daemon is running, stale, or stopped, and which socket it owns. |
| Harnesses | Whether Codex or Claude Code is available on PATH. |
| Next steps | A suggested coven run <harness> "..." command when a harness is available. |
Common next steps
If the daemon is stopped:
coven daemon startIf the daemon is stale:
coven daemon restartIf no harness is ready, install or authenticate one of the supported harness CLIs, then run coven doctor again.
Support evidence
For support reports, include:
- The exact
coven doctoroutput. - The command you expected to work.
- The current working directory, if it is not private.
- Whether you use custom
COVEN_HOME.
For daemon-specific failures, continue with Daemon commands and Daemon observability.
Was this page helpful?No
Last updated on