Hands-free voice control for Claude Code on macOS. Say "Hey Claude", speak your
prompt, and it lands directly in the Claude Code terminal — with @file mentions
auto-tagged. Fully on-device (Apple Neural Engine via WhisperKit); nothing leaves
your Mac.
macOS only (Apple Silicon). Works in VS Code and Cursor.
How it works
The extension manages a small local voice daemon: wake word → on-device
transcription → @-file tagging → it types the command into the active terminal where
Claude Code runs. An animated overlay shows the live state — blue listening,
red recording, green sent.
Setup
Install this extension.
Install the backend (one time) — click "Install backend" when prompted, or run:
(Pins Python 3.12 — the on-device deps have no Python 3.14 wheels yet.)
Reload the window. Grant Microphone permission when macOS asks. The first run
downloads the WhisperKit speech model (one time).
Open a terminal, start claude, then say "Hey Claude …".
Controls
Click claude_purr in the status bar for the menu:
Pause (microphone off) · Resume · Restart · Stop · Show log.
The status icon shows the state: $(mic) active · $(debug-pause) paused · off.
Settings
Language — transcription language for your dictation (default German; the UI stays English).
Wake sensitivity — how easily "Hey Claude" triggers (lower = more sensitive).
Silence threshold, Overlay on/off, and an optional Backend path (advanced).
Privacy
All speech recognition runs locally on-device. No audio or text is sent to any server.
