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 viastopVoiceEars()after 1s of silence. - Working (agent running):
AppState.isWorking=truedrives a tail/leg scurry micro-motion: faster leg wiggle and slight offset while work is in-flight. Currently toggled around Chat agent runs.
- Voice wake: runtime/tester call
AppState.triggerVoiceEars(ttl: nil)on trigger andstopVoiceEars()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 indeferblocks to avoid stuck animations.
- Base icon drawn in
CritterIconRenderer.makeIcon(blink:legWiggle:earWiggle:earScale:earHoles:). - Ear scale defaults to
1.0; voice boost setsearScale=1.9and togglesearHoles=truewithout 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.
- 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.