Reply to a waiting agent
A Claude Code hook tells Mouthpiece when an agent is waiting for you. Press ⌃⌥R, answer out loud, and the reply lands in that agent's window while you stay where you were.
New in 0.3: built for coding agents
Dictation that speaks developer.
Talk to Claude Code, Cursor and your terminal. The text lands at your cursor
with @file tags, snake_case and line breaks where they belong,
and nothing leaves your Mac.
Latest version · Free and open source · Apple Silicon · macOS 12+
¼ s
from the moment you stop talking to text, in our real-speech test
0 bytes
of your voice leave your Mac. No account, no cloud fallback.
$0
No paid tier, no usage limits. Open source under the MIT license.
New in 0.3
Made for talking to coding agents.
Claude Code, Cursor and the terminal are where most of your words go now. These features are for them.
Knows your codebase
Names come from the repo you're in, so "the paste text function in the paste file"
comes out as paste_text in @src-tauri/src/paste.rs.
Transcribes while you talk
Each phrase is transcribed at the pause after it. Long pauses cost nothing, and the text is ready a quarter of a second after you stop.
"Send it." "Attach the error."
Submit the prompt, add your latest stack trace as a code block, or say "scratch that" to take back the last paste.
Learns your corrections
History keeps what you said next to the cleaned-up text. Fix the same word twice and it offers to remember it.
What you say, and what gets typed.
The same voice, formatted for the app in front of you. Real outputs from the app's test suite.
-
Claude Code
Look at recording.rs and fix the crash.
Look at @recording.rs and fix the crash -
Cursor
Camel case user profile ID
userProfileId -
Terminal
Git commit update readme
git commit -m "update readme" -
Anywhere
One, fix the tests. Two, ship it.
1. Fix the tests.
2. Ship it. -
Slack
Let's meet at two, actually three.
Let's meet at three. -
GitHub
PR checklist
- [ ] Tests pass locally
- [ ] Added/updated tests…
Everything between the key press and the paste.
Fits where you're typing
- Knows the app you're in
- Sentences in Slack and email. File tags and real line breaks in Claude Code, Cursor and your terminal. Set your own mode for any app.
- Progress you can see
- An amber bar while it transcribes, a violet one while the LLM tidies up, each with a real percentage.
- Paste it as-is
- Click the violet bar, or add Shift to your hotkey, and the transcript pastes without waiting for the LLM.
Speaks developer
- Your vocabulary
- An editable list of the terms you use, so
kubectlandHammerspooncome out right. The LLM sees it too, so it won't "fix" them. - Casing on command
- Say "snake case", "camel case", "kebab case", "Pascal case" or "screaming snake case" before a name.
- Backtrack, lists, punctuation
- "Actually" corrects you mid-sentence. Spoken lists become numbered lists. Say "period" or "new line" when you want them.
- Snippets and boilerplate
- A short cue pastes a saved block of text. "Generate boilerplate for…" writes the code.
Stays out of your way
- Only refines when it helps
- Clean sentences skip the LLM entirely. Fillers, stutters and casual chat get a quick pass.
- Hands-free if you want it
- Say "Mouthpiece, …" and only your enrolled voice triggers it. It pauses itself during calls.
- Scriptable
open mouthpiece://start-recordingfrom any tool, plus a webhook for each finished transcript.- History and insights
- Search every past dictation, re-run one through a different mode, and see your speaking speed.
How it compares.
Wispr Flow and Superwhisper are great general-purpose dictation apps that run on more devices and in more languages. Mouthpiece is narrower: English, Apple Silicon, and tuned for code.
| Feature | Mouthpiece | Wispr Flow | Superwhisper |
|---|---|---|---|
| Price | Free, no paid tier | Free tier, Pro from $12/mo | Free tier, Pro from $8.49/mo |
| Where your speech is processed | On your Mac | In the cloud | On your Mac or in the cloud |
| Source code | Open source (MIT) | Closed | Closed |
| Names from your codebase | Automatic | Custom dictionary | Custom vocabulary |
| Devices | Mac (Apple Silicon) | Mac, Windows, iPhone, Android | Mac, Windows, iOS, Android |
| Languages | English | 100+ | 100+ |
From each app's own website and pricing page, October 2026.
Your voice never leaves your Mac.
Speech recognition runs in whisper.cpp on your Mac's GPU. The optional LLM cleanup runs in Ollama, also on your Mac, and Ollama's cloud models are blocked. There's no account, no telemetry and no cloud fallback. This is everything the app ever connects to:
WhatWhereWhen
Your speechthis Macalways
LLM cleanuplocalhost:11434if Ollama is installed
Update checkgithub.comat launch
Speech modelshuggingface.cowhen you click Download
Webhookyour URLonly if you set one
Good questions.
Something else? Open an issue.
macOS says Mouthpiece can't be opened, or is damaged.
Mouthpiece isn't notarized by Apple yet, so macOS blocks the first launch. Open it once, then go to System Settings → Privacy & Security, scroll down and click Open Anyway. On macOS 14 or earlier, right-click the app and choose Open instead.
To skip that step entirely, install with the one-line command or build it from source.
Versions before 0.3.1 show "damaged" instead. Download the latest version, or
run xattr -dr com.apple.quarantine "/Applications/Mouthpiece.app"
in Terminal.
Is it safe? Could it contain malware or leak what I say?
Mouthpiece is open source, so anyone can read exactly what it does. What we check:
- Your voice stays on your Mac. Speech recognition and the optional cleanup both run locally. The list above is every connection the app makes, and none of them carry what you say.
- No cloud models. Ollama can run some models on its own servers. Mouthpiece hides those and refuses to use them, so cleanup never leaves your Mac.
- Your transcripts are yours. History stays on your Mac in a file only your account can read. You can lock it behind Touch ID or your password, and logs leave out what you said unless you turn that on.
- Dependencies are scanned. Every change is checked against the public databases of known vulnerabilities in the libraries the app uses, and the build fails if one turns up.
- Downloads are verified. Speech models are checked against known checksums, and updates must carry our signature before they install.
The realistic risk is the one every app has: bugs. Mouthpiece types into other apps and listens while you hold the key, so a bug could put text in the wrong place. If you hit one, please open an issue.
Do I need Ollama?
No. Without it you still get formatting for each app, casing commands, file tags, lists, punctuation and snippets. Ollama adds an optional cleanup pass for rambling or casual speech, and it also runs on your Mac. Ollama's cloud models are hidden and never used, to keep your text private.
How do I connect it to Claude Code?
Open Settings → Coding agents, copy the hook config, and add it to
~/.claude/settings.json. From then on, the widget shows when an agent
is waiting, and ⌃⌥R records your reply.
Which apps does it work in?
Any app you can paste into. Terminals, Claude Code, Cursor, VS Code, Slack, email and browsers each get their own formatting, and you can set a mode for any other app.
Does it work on an Intel Mac?
No. It needs Apple Silicon (M1 or later), whose GPU runs the speech model fast enough to feel instant.
Other languages?
English only for now. The speech models it ships with are tuned for English, which keeps them small and quick.
Say it. Ship it.
Free for Macs with Apple Silicon, macOS 12 or later. Updates install themselves.
Download Mouthpiece.dmgLatest version · All releases
- Install Open the DMG and drag Mouthpiece into Applications.
- Allow it once Open it, then click Open Anyway in System Settings → Privacy & Security. It isn't notarized by Apple yet.
- Set up Follow the checklist in Settings: download a speech model (Base, 57 MB, is a good start) and allow Accessibility so it can paste.
- Optional: add cleanup Install Ollama, then pick a small model in Settings → LLM.
Other ways to install
Mouthpiece isn't notarized by Apple yet (that costs $99 a year), so a download from the button above needs the one-time "Open Anyway" step. These two skip it.
One-line install
Paste into Terminal. It downloads the same DMG from GitHub, checks the app's signature and copies it into Applications. Files downloaded this way aren't flagged, so macOS doesn't prompt. Read the script first if you like.
curl -fsSL https://jfinchy.github.io/mouthpiece/install.sh | sh
Build from source
Anything you build on your own Mac runs without the prompt. You'll need Rust and Bun; the steps are in the README.
git clone https://github.com/JFinchy/mouthpiece