From f65fd5df4d9f9bef0be585477c09479a91a46152 Mon Sep 17 00:00:00 2001 From: Alan Wizemann Date: Fri, 24 Apr 2026 03:43:42 +0200 Subject: [PATCH] docs(health): document Web Dashboard launcher (hermes dashboard on :9119) --- Gateway-Cron-Health-Logs.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/Gateway-Cron-Health-Logs.md b/Gateway-Cron-Health-Logs.md index a9641aa..33cd040 100644 --- a/Gateway-Cron-Health-Logs.md +++ b/Gateway-Cron-Health-Logs.md @@ -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)_