From e19f00d7704dae7b14549c434851d29db5fcbf0c Mon Sep 17 00:00:00 2001 From: Brooklyn Nicholson Date: Fri, 14 Aug 2026 01:40:44 -0500 Subject: [PATCH] =?UTF-8?q?docs(desktop):=20document=20HUD=20mode=20?= =?UTF-8?q?=E2=80=94=20long-press=20to=20move,=20resize,=20snap,=20exit?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The desktop docs had no HUD mode section at all. Add one covering the key interaction (long-press the composer to drag the bar), plus resize, snap-to-pointer, and exit — all sourced from the actual implementation in composer-drag.ts, resize-handle.ts, and keybinds/actions.ts. --- website/docs/user-guide/desktop.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.md index bfbdf249935b1..77145c6514976 100644 --- a/website/docs/user-guide/desktop.md +++ b/website/docs/user-guide/desktop.md @@ -127,6 +127,15 @@ Quick Entry is a small always-available composer summoned by a **global hotkey f Talk to Hermes and hear it back, the same [voice mode](./features/voice-mode.md) available elsewhere. On macOS the OS will prompt once for microphone access. +### HUD mode + +**⌘/Ctrl+Shift+H** (or the titlebar button) detaches the chat into a chrome-free, always-on-top floating bar that sits over whatever you are working in. The app window steps aside; the HUD keeps your live conversation and a composer. Where you park it is context — the bar's position tells Hermes which app and screen you're asking about, so "this", "here", and "that page" resolve to what's underneath it. + +- **Moving the bar** — **press and hold** anywhere on the composer for a beat, then drag. A quick press still types; a held press grabs the window. This is the only way to move the HUD — there is no titlebar to drag. +- **Resizing** — drag the bottom-right corner of the bar. +- **Snap to pointer** — **⌘/Ctrl+Shift+G** (a global hotkey, works from any app) jumps the HUD to wherever your cursor is. +- **Exiting** — click the exit button on the bar, or press **⌘/Ctrl+Shift+H** again. The app window comes back with your session intact. + ### Settings & onboarding Manage providers, models, tools, and credentials from a real UI instead of editing YAML. First-run onboarding gets you to your first message in seconds. The settings panes cover providers/keys, model selection, toolset configuration, MCP servers, the gateway, and session management.