CC-Beeper

CC-Beeper is a native macOS desktop widget that keeps you informed about what Claude Code is doing without requiring you to watch your terminal. It tracks 8 real-time states with pixel-art animations, lets you respond to permission requests and questions via global hotkeys or voice, and supports fully on-device speech recognition and text-to-speech. Built entirely with Swift and SwiftUI, it runs locally with zero outbound connections, no accounts, and no API keys required.

• Real-Time State Tracking — Monitors 8 Claude Code states (Snoozing, Working, Done, Error, Allow, Input, Listening, Recap) with animated pixel-art indicators and priority-based display across multiple concurrent sessions.
• Auto-Accept Modes — Four presets (Strict, Relaxed, Trusted, YOLO) let you control how aggressively Claude Code tool requests are auto-approved, switchable anytime from the menu bar.
• Voice Dictation — Toggle recording with ⌥R or a double clap; uses WhisperKit (on-device, 99 languages) or Apple Speech as a fallback — no cloud, no API key needed.
• Read Aloud (TTS) — Hear Claude's last response spoken aloud using Kokoro (on-device, 54 voices, 9 languages) or Apple Speech.
• Global Hotkeys — Five remappable hotkeys (approve, deny, record, focus terminal, stop TTS) work from any app in any keyboard layout.
• Themes & Sizes — Choose from 10 shell colors and 3 widget sizes (Large, Compact, Menu Only), plus sound and haptic feedback for permission requests and task completion.
• Privacy-First Architecture — All communication happens over localhost (127.0.0.1); no telemetry, no analytics, no crash reporting, and no outbound connections of any kind.
• Easy Setup — Download the DMG, move CC-Beeper.app to /Applications, and launch — the onboarding wizard configures Claude Code hooks, permissions, voice engines, and hotkeys automatically.