# CC-Beeper

> A floating macOS desktop widget for Claude Code that shows real-time AI agent status, enables voice dictation, and lets you approve permissions without switching apps.

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.*

## Features
- Real-time Claude Code state tracking with 8 states and pixel-art animations
- Auto-accept modes: Strict, Relaxed, Trusted, YOLO
- On-device voice dictation via WhisperKit (99 languages) or Apple Speech
- Text-to-speech read-aloud via Kokoro (54 voices, 9 languages) or Apple Speech
- Global hotkeys remappable in Settings
- Multi-session tracking with priority-based state resolution
- 10 shell color themes and 3 widget sizes
- Sound and haptic feedback for events
- Fully local — no telemetry, no accounts, no API keys
- Hooks integrate via ~/.claude/settings.json

## Integrations
Claude Code, Terminal.app, iTerm2, Warp, Alacritty, Kitty, WezTerm, WhisperKit, Kokoro, Apple Speech

## Platforms
WINDOWS, MACOS, LINUX, API, CLI

## Pricing
Open Source

## Version
v1.0.0

## Links
- Website: https://github.com/vecartier/cc-beeper
- Documentation: https://github.com/vecartier/cc-beeper#readme
- Repository: https://github.com/vecartier/cc-beeper
- EveryDev.ai: https://www.everydev.ai/tools/cc-beeper