blurt 0.5.1

Talk to your coding agents. On-device voice-to-text for macOS Apple Silicon. No cloud, no API keys.

░█▀▄░█░░░█░█░█▀▄░▀█▀
░█▀▄░█░░░█░█░█▀▄░░█░
░▀▀░░▀▀▀░▀▀▀░▀░▀░░▀░
  

Talk to your coding agents.

On-device voice-to-text for macOS. Hold right ⌘, speak, release - your words go straight into Claude Code, Codex, Cursor, OpenCode or any other agent, wherever your cursor is.

Install

pipx install blurt

Requires pipx (brew install pipx) and macOS with Apple Silicon.

First run downloads the Whisper model (~1.6 GB, one-time). macOS will prompt for Microphone and Accessibility access (System Settings → Privacy & Security).

Usage

Action	Description
Hold right ⌘	Start recording
Release right ⌘	Stop, transcribe, paste at cursor
Ctrl + C	Quit

Custom Words

Teach Blurt words it gets wrong (names, jargon, acronyms):

blurt add "Claude Code"   # add a word
blurt vocab               # list all
blurt rm "Claude Code"    # remove

Words are stored in ~/.blurt/vocab.txt (one per line).

Transcript History

blurt log                 # view recent transcripts

Logs are stored in ~/.blurt/log.txt.

Update

blurt upgrade

Troubleshooting

Issue	Fix
"Microphone access" prompt doesn't appear	System Settings → Privacy & Security → Microphone → enable your terminal
"Accessibility" error	System Settings → Privacy & Security → Accessibility → enable your terminal
No audio / recording fails	brew install portaudio then restart your terminal
Model download stalls	Check disk space (~1.6 GB needed in ~/.cache/huggingface/)

Contributing

git clone https://github.com/satyaborg/blurt.git
cd blurt
uv pip install -e ".[dev]"
pytest

Privacy

Everything runs on your Mac. No network calls, no telemetry, no data collection. Audio files are saved locally to ~/.blurt/audio/ and never leave your device.

License

MIT