docs(health): document Web Dashboard launcher (hermes dashboard on :9119)

Alan Wizemann
2026-04-24 03:43:42 +02:00
parent 741b253fe3
commit f65fd5df4d
+11 -1
@@ -49,6 +49,16 @@ Component-level status and diagnostics. Mirrors `hermes status` and `hermes doct
- **Run Dump** — captures `hermes dump` output inline.
- **Share Debug Report** — uploads a structured report to Nous support, with a confirmation dialog before sending.
### Web Dashboard launcher (local only)
Hermes ships a local web UI (`hermes dashboard`) on port 9119 for config / session management. The Health header shows its live state:
- **Launch Dashboard** spawns `hermes dashboard --no-open --port 9119` detached, waits for the port to bind (probing `/api/status` up to ~6s), then opens `http://127.0.0.1:9119` in the default browser.
- **Open in Browser** / **Stop** take over once the dashboard is running. Stop works whether Scarf launched it or you started it from a terminal — it falls back to `pkill -f "hermes dashboard"` in the external case.
- Liveness is polled every 3 seconds via a 500ms `GET /api/status` — that endpoint is whitelisted in Hermes's `_PUBLIC_API_PATHS` so no session token is needed for detection.
The row is hidden for remote servers — the dashboard binds 127.0.0.1 by default and SSH tunneling isn't wired up yet.
## Log Viewer
Real-time tail for the three main logs at `~/.hermes/logs/`:
@@ -92,4 +102,4 @@ Restructured in 1.6 into a 10-tab layout exposing ~60 previously hidden config f
- [Updating](Updating) — Sparkle, the appcast, and how the auto-update flow works.
---
_Last updated: 2026-04-20 — Scarf v2.0.1_
_Last updated: 2026-04-24 — Scarf v2.3 (Web Dashboard launcher in Health; ships in v2.4)_