CC-BEEPER

The widget tracks eight states and gives each one its own pixel-art animation, so you can read the situation without parsing text. You'll see the difference between SNOOZING (idle), WORKING (running a tool), DONE, ERROR, ALLOW?, INPUT?, LISTENING, and RECAP. Higher-urgency events take priority when several sessions are active. A pending permission always jumps ahead of a quiet one.

CC-BEEPER lets you choose how much Claude Code can do without asking. Strict asks on every action. Relaxed allows reads and asks before writes and commands. Trusted permits file operations while still checking shell commands. YOLO approves everything, including deletes and network calls, with no prompt. You can switch presets from the menu bar at any time, and the menu bar icon changes color so you can spot which mode is live.

You can prompt Claude or answer its questions by talking. Toggle recording with ⌥R from any app, or double clap to go hands-free. Dictation runs on WhisperKit on-device across 99 languages, with Apple Speech as a built-in fallback, and it works with Terminal.app, iTerm2, Warp, Alacritty, Kitty, and WezTerm, which covers most of the terminals Mac developers actually use. Read-aloud uses the on-device Kokoro engine with 54 voices across 9 languages to play Claude's last reply back to you.

Five hotkeys work from any app and in any keyboard layout, including AZERTY, QWERTZ, and Dvorak. ⌥A approves, ⌥D denies, ⌥R toggles dictation, ⌥T focuses the active terminal, and ⌥M stops speech or replays the last response. All of them are remappable in Settings, so you don't have to relearn muscle memory.

You can pick from 10 shell colors and three widget sizes: Large, which shows buttons and an LCD, Compact, which shows the LCD only, or Menu Only, which keeps just an icon in the menu bar. Sound and haptics add a ping on permission requests, a chime on completion, and a vibration that repeats until you deal with the request. Those cues are what make the widget useful from across the room.

Every message travels over localhost through plain curl hooks. There's no telemetry, analytics, or crash reporting, and the app makes zero outbound connections. Voice never leaves your Mac because both engines run on-device. There are no accounts or tokens, and the hooks live in ~/.claude/settings.json, where you can inspect or remove them whenever you want.

CC-BEEPER manages several concurrent Claude Code sessions and picks the displayed state by priority across all of them, so the session that needs you most is the one you see. Sessions prune themselves automatically after two hours of inactivity, so the widget doesn't get cluttered with abandoned tabs. On launch it pings ports 19222 to 19230 to detect another running instance and avoid conflicts.