CC-Beeper is a native macOS desktop widget designed to streamline the experience of using Claude Code, Anthropic's terminal-based coding assistant. It eliminates the need to constantly switch back to a buried terminal by providing a visual, real-time "LCD" pager that tracks Claude's current state. The app features pixel-art animations for various statuses such as working, pending permission, or errors and supports global hotkeys for quick approvals. For a truly hands-free experience, CC-Beeper integrates on-device AI for dictation and text-to-speech, allowing you to prompt Claude or hear summaries out loud. It is built with a "Privacy First" philosophy, ensuring all data remains local with no inbound or outbound cloud connections.
Key Features
- Real-Time State Tracking: Visualizes 8 distinct Claude Code states with retro pixel-art animations so you know exactly when your input is needed.
- Hands-Free Dictation: Respond to Claude using your voice with on-device WhisperKit support (supporting 99 languages) or Apple Speech.
- Auto-Accept Modes: Choose from four presets Strict, Relaxed, Trusted, or YOLO to automate tool approvals while maintaining your preferred level of control.
- Read Aloud (TTS): Hear Claude's last response summarized aloud using Kokoro or Apple Speech, allowing you to focus on other tasks.
- Global Hotkeys: Remappable shortcuts to approve/deny permissions, toggle recording, or focus the active terminal from any app.
- Customizable Themes & Sizes: Choose from 10 shell colors and 3 widget sizes (Large, Compact, or Menu Bar only) to fit your workspace aesthetic.
Use Cases
- Multitasking Development: Run long-running Claude Code tasks in the background while working in your IDE, receiving a visual "ping" only when Claude hits a blocker.
- Accessibility & Voice Control: Use "Double Clap" dictation to interact with your coding assistant without needing to touch your keyboard or mouse.
- Safe Automation: Utilize the "Relaxed" or "Trusted" auto-accept modes to let Claude perform routine file reads while staying in the loop for risky shell commands.
- Session Monitoring: Keep track of multiple concurrent Claude Code sessions with a prioritized status resolution shown on your desktop.
- Privacy-Conscious AI Work: Enjoy full AI-enhanced terminal interactions with the peace of mind that no audio or command data is ever uploaded to a third-party server.
