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:
```
brew install whisperkit-cli pipx [email protected]
pipx install claude-purr --python $(brew --prefix [email protected])/libexec/bin/python
```
(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).