Overview
hermes doctor diagnoses problems with your Hermes setup: configuration, dependencies, credentials, and security advisories. It reports exactly what is wrong and what to do next.
Usage
hermes doctor [--fix] [--ack ADVISORY_ID]Options
| Flag | Description |
|---|---|
--fix |
Attempt to fix issues automatically when possible. |
--ack ADVISORY_ID |
Acknowledge a security advisory by ID. After acking, the advisory will no longer trigger startup banners. Run hermes doctor first to see active advisories and their IDs. |
Examples
# Diagnose the current setup
hermes doctor
# Diagnose and try to fix issues
hermes doctor --fix
# See advisories, then acknowledge one
hermes doctor
hermes doctor --ack HERMES-2026-0001Tips
- Run
hermes doctorafter installation or whenever a command fails unexpectedly. - Not all issues can be auto-fixed; read the report for manual steps.
- Only acknowledge an advisory after you have reviewed the mitigation steps.
See also
hermes dump, hermes setup, hermes update, hermes config.