> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fased.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Menu Bar Icon

# Menu Bar Icon States

Updated: 2025-12-06 · Scope: macOS app (`apps/macos`)

* **Idle:** Normal icon animation (blink, occasional wiggle).
* **Paused:** Status item uses `appearsDisabled`; no motion.
* **Voice trigger (big ears):** Voice wake detector calls
  `AppState.triggerVoiceEars(ttl: nil)` when the wake word is heard. Ears scale
  up while the utterance is captured, get circular ear holes for readability,
  then drop via `stopVoiceEars()` after 1s of silence.
* **Working (agent running):** `AppState.isWorking=true` drives a tail/leg
  scurry micro-motion: faster leg wiggle and slight offset while work is
  in-flight. Currently toggled around Chat agent runs.

Wiring points

* Voice wake: runtime/tester call `AppState.triggerVoiceEars(ttl: nil)` on
  trigger and `stopVoiceEars()` after 1s of silence to match the capture window.
* Agent activity: set `AppStateStore.shared.setWorking(true/false)` around work
  spans. Keep spans short and reset in `defer` blocks to avoid stuck animations.

Shapes & sizes

* Base icon drawn in `CritterIconRenderer.makeIcon(blink:legWiggle:earWiggle:earScale:earHoles:)`.
* Ear scale defaults to `1.0`; voice boost sets `earScale=1.9` and toggles
  `earHoles=true` without changing the overall frame.
* Scurry uses leg wiggle up to \~1.0 with a small horizontal jiggle; it’s additive to any existing idle wiggle.

Behavioral notes

* No external CLI/broker toggle for ears/working; keep it internal to the app's
  own signals to avoid accidental flapping.
* Keep TTLs short (\<10s) so the icon returns to baseline quickly if a job hangs.