doctor command reference
every doctor cli command and address: status, diagnose, heal, restart, reinstall, update, and the local status page at 127.0.0.1:3852.
doctor's commands cover status, diagnosis, healing, restarting, reinstalling, updating, and service registration. its only network surface is the read-only status page at 127.0.0.1:3852.
Every command and address doctor exposes. Run doctor on its own for the full menu.
#Commands
| Command | Purpose |
|---|---|
doctor status |
Daemon health, service state, versions, last heal, and opt-out flags. |
doctor diagnose |
Classify health and print the recommended fix. Takes no action. |
doctor heal |
Run the repair ladder once. Gated steps confirm first. |
doctor restart |
Restart the primary daemon. |
doctor reinstall |
Reinstall the primary daemon. |
doctor uninstall-hivemind |
Remove a conflicting global package. Confirms first. |
doctor update [--check] |
Update the primary daemon via the approved-release gate. --check previews. |
doctor self-update |
Update doctor's own package. The only thing that does. |
doctor install-service |
Register the OS service. |
doctor uninstall-service |
Remove the OS service. |
doctor logs [--daemon <name>] |
Tail incident logs for all daemons, or one. |
doctor never updates itself in the background, self-update is the single explicit way. There is deliberately no command to clear credentials.
#Surfaces
| Surface | Address | Purpose |
|---|---|---|
| Status page | http://127.0.0.1:3852 |
Human-readable fleet health. |
| Status feed | GET /status.json |
The same fleet model, machine-readable. |
| Health stream | GET /events |
The single live stream doctor feeds to hive. |
hive, the portal at http://127.0.0.1:3853, renders a richer view of this same health data, live. doctor ships no MCP server and no SDK, and opens no inbound port beyond the loopback status page.
#Other daemon addresses
For context when reading doctor's output, the daemons it watches sit on their own ports:
| Daemon | Address |
|---|---|
| honeycomb (memory) | 127.0.0.1:3850 |
| embeddings (honeycomb's child) | 127.0.0.1:3851 |
| doctor (status page) | 127.0.0.1:3852 |
| hive (portal) | 127.0.0.1:3853 |
| nectar (codebase) | 127.0.0.1:3854 |
#Package
Installed globally as @legioncodeinc/doctor.
#Common questions
How do I see what doctor is doing right now without changing anything?
Run doctor diagnose. It classifies current health and prints what it would recommend, but takes no action.
How do I check for an update without applying it?
Run doctor update --check. It previews the update without installing it.
Where do I look for a service by name?
doctor logs --daemon <name> tails the incident log for that one daemon instead of the whole fleet.