From fb56a7e06dde62e9f645ff744c82cb47b60c469e Mon Sep 17 00:00:00 2001 From: brooklyn! Date: Wed, 16 Sep 2026 00:49:27 -0700 Subject: [PATCH] docs(desktop): the wake-word ear and speaker live in the mic's fan The desktop guide and the wake-word page told users to click an ear in the composer row; it now fans out of the microphone on hover. The folded voice menu, not the ear, carries the silent-mic hint. --- website/docs/user-guide/desktop.md | 2 ++ website/docs/user-guide/features/wake-word.md | 6 ++++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.md index a75728202c..7dbac9e84a 100644 --- a/website/docs/user-guide/desktop.md +++ b/website/docs/user-guide/desktop.md @@ -97,6 +97,8 @@ Changing any of these values invalidates only that profile's disk-discovery cach The model picker lives in the **composer**, just left of the microphone. Click it to switch the model; hover a model row for its options (thinking, effort, fast). Next to it, a **reasoning pill** shows the active model's effort level (`Med`, `High`, …) and opens the same options directly, so you can change effort without finding the model's row. The pill is hidden for models whose catalog reports no reasoning control. +The **microphone** is dictation; hover it and the other voice toggles fan out above it — **Read replies aloud** and the **wake word** ear. A toggle that is on shows as a solid disc. Starting a full voice conversation stays on the primary button to the right. In the HUD and in narrow tiles the same controls fold into one menu behind the mic instead. + - **The composer picker is sticky UI state and never touches your default.** It's remembered locally (per device) and **follows** across new chats and restarts instead of snapping back to the default — pick a model once and the next `Cmd/Ctrl+N` opens on it. With a live chat, switching models scopes the change to that **current chat**; either way the selection rides along when the session is created/switched and is **never** written to the profile default — with one exception: on a fresh profile that has no `model.default`/`model.provider` configured yet, the first pick is persisted so the app has a real default instead of falling through to a stray API-key env var on restart. Persistence follows the same rule as `/model` (`model.persist_switch_by_default`); use **Settings → Model** to change the default deliberately. (Switching [profiles](#sessions--profiles) reseeds to that profile's own default.) - **Set the default in Settings → Model.** That "main" model is your **per-profile global default** — it's what new chats, crons, subagents, and auxiliary tasks start from, and it's the only place that writes it. Each [profile](#sessions--profiles) keeps its own default. - **Per-model effort/fast presets.** Each model remembers its own reasoning effort and fast-mode choice in the desktop app, re-applied to the session whenever you pick that model. These presets are a desktop convenience and don't change crons or subagents. diff --git a/website/docs/user-guide/features/wake-word.md b/website/docs/user-guide/features/wake-word.md index 622532cd5f..ecf7b858b6 100644 --- a/website/docs/user-guide/features/wake-word.md +++ b/website/docs/user-guide/features/wake-word.md @@ -101,7 +101,8 @@ cd ~/.hermes/hermes-agent && uv pip install -e ".[wake]" /wake off # stop listening ``` -In the desktop app, click the ear icon in the composer. +In the desktop app, hover the microphone in the composer and click the ear +that fans out of it. The ear is solid when the wake word is listening. The toggle IS the setting: turning the wake word on or off — via `/wake` or the desktop ear button — also writes `wake_word.enabled` to `~/.hermes/config.yaml`, @@ -304,7 +305,8 @@ proves the *renderer* has mic access — the wake listener runs in the Python *backend*, which needs its own grant. Without it, CoreAudio hands the backend a "working" stream that only ever delivers silence, so the ear shows listening but the phrase never fires. Hermes detects this (`/wake status` shows -"mic delivers only silence"; the desktop ear tooltip carries the same hint). +"mic delivers only silence"; the desktop's folded voice menu carries the same +hint on its trigger). Fix: System Settings → Privacy & Security → Microphone → enable the Hermes backend (it may appear as your terminal, `python`, or Hermes), then toggle the wake word off and on.