hive command reference
every hive cli command, dashboard page, and portal route: start, install-service, register, and the endpoints served at 127.0.0.1:3853.
hive has four commands, start, install-service, uninstall-service, and register, plus a set of dashboard pages and portal api routes all served from one origin at 127.0.0.1:3853.
Every command, page, and route hive exposes. Run hive on its own for the full menu.
#Commands
Four verbs; hive start is the default.
| Command | Purpose |
|---|---|
hive start |
Run the portal daemon on 127.0.0.1:3853. |
hive install-service |
Install the OS service unit, then register with doctor. |
hive uninstall-service |
Remove the OS service unit. Does not remove the doctor registry entry. |
hive register |
Add or update hive's entry in doctor's daemon registry. |
#Dashboard pages
/, /projects, /harnesses, /memories, /graph, /hive-graph, /sync, /logs, /health, /roi, and /settings, plus the gate-exempt /buzzing readiness screen and /login.
#Portal endpoints
| Route | Purpose |
|---|---|
GET /health |
Liveness JSON, or the health page when the request accepts HTML. |
GET /api/fleet-status |
A projection of doctor's status page. |
GET /api/registered-services |
The services in doctor's registry file. |
GET /api/telemetry/stream |
A server-sent-events relay of doctor's health stream. |
ALL /api/*, ALL /setup/* |
The proxy, to honeycomb or nectar. |
#OS service units
| Platform | Manager | Unit |
|---|---|---|
| macOS | launchd, user domain | com.legioncode.hive |
| Linux | systemd, user | hive.service |
| Windows | Scheduled Task | task hive |
#Surfaces
hive has two surfaces only: the dashboard at http://127.0.0.1:3853, and its HTTP portal API. It ships no MCP server and no SDK.
#Other daemon addresses
For context, the daemons hive proxies to sit on their own ports behind the scenes, you never need to visit these directly:
| Daemon | Address |
|---|---|
| honeycomb (memory) | 127.0.0.1:3850 |
| doctor (status page) | 127.0.0.1:3852 |
| hive (portal) | 127.0.0.1:3853 |
| nectar (codebase) | 127.0.0.1:3854 |
#Common questions
How do I add hive back to doctor's registry after removing it?
Run hive register. It adds or updates hive's entry in doctor's daemon registry without needing a full reinstall.
Where do I check if the portal itself is alive?
GET /health on the portal returns liveness JSON, or the health page itself if your browser requests HTML.
Does hive expose an MCP server or SDK? No. hive's only two surfaces are the dashboard and its HTTP portal API.