CC Beeper

CC-Beeper

A floating macOS pager for Claude Code.

*Stop babysitting your terminal. Start shipping.*

Why I Made This

You kick off a task in Claude Code. Then life happens. Claude finishes, or hits an error, or needs a permission — but your terminal is buried under three windows.

CC-Beeper fixes that. It's a small widget that sits on your desktop, shows what Claude is doing, and lets you respond without switching apps. Never miss an update. Respond without breaking your flow.

See It in Action

https://github.com/user-attachments/assets/9df11591-ec91-4ddb-8cbe-a6c4b2a41c9a

Features

Real-Time States

At a glance, know exactly what Claude is up to. CC-Beeper tracks 8 states, each with its own pixel-art animation. Higher-urgency events always take priority.

Auto-Accept Modes

When Claude Code needs to use a tool, CC-Beeper can auto-approve it or ask you first. Four presets let you dial the automation while keeping control. Switchable anytime from the menu bar.

Voice

Dictation

Prompt Claude, or answer its questions, just by talking. Toggle with ⌥R from anywhere, or double clap to go fully hands-free.

- WhisperKit — on-device, 99 languages, no cloud, no API key
- Apple Speech — built-in fallback, no download needed
- Works with Terminal.app, iTerm2, Warp, Alacritty, Kitty, and WezTerm

Read Aloud

Claude finished? Hear the summary out loud.

- Kokoro — on-device, 54 voices across 9 languages
- Apple Speech — built-in fallback

Global Hotkeys

Use them from any app, in any keyboard layout (AZERTY, QWERTZ, Dvorak). All remappable in Settings.

Themes, Sizes & Sound

- 10 shell colors
- 3 widget sizes — Large (buttons + LCD), Compact (LCD only), or Menu Only (icon in the menu bar)
- Sound & haptics — ping on permission requests, chime on task completion, vibration…