From 9c6fe3aa7577e48e0dfabf907a01bd383ea0c9fb Mon Sep 17 00:00:00 2001 From: Brooklyn Nicholson Date: Mon, 28 Sep 2026 20:49:30 -0500 Subject: [PATCH] docs(desktop): keep the ARM64 window-context note inside the Troubleshooting section The new ### heading was inserted between '### Troubleshooting' and its bullet list, orphaning the dashboard sign-in bullets out of their section. --- website/docs/user-guide/desktop.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.md index 3b701a07a9..6445b10e9e 100644 --- a/website/docs/user-guide/desktop.md +++ b/website/docs/user-guide/desktop.md @@ -547,10 +547,10 @@ context cannot enumerate other apps' windows. The error and HUD log preserve the underlying failure reason alongside this troubleshooting guidance. If the binding is unavailable, use the x64 desktop build under Windows -emulation, or a custom build with a matching native binding. Changing the agent backend or granting macOS screen -permissions cannot fix a missing Windows binding; enumeration runs on the -computer hosting the desktop app. This diagnostic does not add native ARM64 -window enumeration support. +emulation, or a custom build with a matching native binding. Changing the agent +backend or granting macOS screen permissions cannot fix a missing Windows +binding; enumeration runs on the computer hosting the desktop app. This +diagnostic does not add native ARM64 window enumeration support. - **Sign-in fails with 401 / "Invalid credentials"** — the username or password doesn't match the backend's `HERMES_DASHBOARD_BASIC_AUTH_USERNAME` / `HERMES_DASHBOARD_BASIC_AUTH_PASSWORD`. The backend returns the same generic error for an unknown user and a wrong password (no enumeration oracle), so double-check both. Confirm the gate is on with `curl -s http://:9119/api/status | jq '.auth_required, .auth_providers'` — it should report `true` and include `"basic"`. - **No "Sign in" button — it asks for a session token instead** — the backend's username/password provider isn't active. `/api/status` won't list `"basic"` in `auth_providers`. Make sure both the username and a password (or password hash) are set in `~/.hermes/.env` and that the dashboard process actually loaded them.