cleanunicorn/earheart

Talk to your coding agents.
Press a hotkey, speak your prompt, press again — it lands in Claude Code,
Codex, Cursor, or whatever else has focus.
Runs on your machine by default: your audio and prompts never leave it.
The overlay transcribes live as you speak, shows progress while it finishes up, then confirms where the text landed — without stealing focus. Dark or light, following your OS.
## Watch Earheart in action
Hotkey → speak → clean up → paste, in 48 seconds with music. Cleanup gets a
before-and-after sequence showing fillers removed, false starts resolved, and
phrasing refined using the optional Polished style.
Download the horizontal video (16:9)
or the vertical video (9:16) for social media.
Open either MP4 in your video player to watch. Both show an illustrated workflow;
see video details.
Working with an agent is a conversation, but you type it like a form. The
prompts that actually work are long — context, constraints, the three things
you already tried, the "no, not like that." Typing all of that is the slow part
of the loop, and the reason people send a one-liner instead and then spend
several turns correcting it.
Earheart turns that part into talking. Press a global hotkey, say what you
want, press it again: your speech is transcribed on-device (NVIDIA Parakeet),
tidied up on-device (Granite 4.0 Micro drops the ums, false starts and
backtracking), and pasted straight into whatever app has focus — the
terminal running Claude Code, the Codex composer, Cursor's chat box, a GitHub
issue, an email.
Your voice and transcripts stay on your machine, which matters more for agent prompts than for
ordinary dictation: what you say to an agent is your own code, your file
layout, your architecture, your unshipped work. Out of the box both models run
inside the app, on your computer — no separate program, no Python, no
account, no telemetry. The setup wizard downloads a
Parakeet speech model and
a Granite 4.0 Micro
cleanup model (with a progress bar) and runs them in-process.
It is still a general-purpose dictation app: the same hotkey works in email,
notes, issues, and any other focused text field.
Prefer your own servers or a hosted API? See
Using other services.
## Talking to agents
Earheart works with any agent you can type into — no integration, plugin, API
key, or account required. It pastes into the focused window and leaves the
prompt for you to review and submit.
If you want Earheart to start the task itself, opt in under Settings → History:
review a transcript, pick a project, and send it to an installed Codex or
Claude Code, then follow, cancel or reply to it. See
docs/agent-tasks.md. The brief then goes to that
agent's provider, so it is off by default.
### Quick start for agents
1. Install Earheart and finish the first-run wizard.
2. Put the cursor in your agent's input — a terminal, editor chat, desktop app,
or browser composer.
3. Press Ctrl/Cmd+Shift+Space, speak the full prompt, then press the hotkey
again.
4. Review the pasted prompt and press Enter yourself.
Per-tool setup recipes — terminal newlines, Wayland hotkeys, and hotkeys that
do not collide with your editor — live in docs/agents.md.
| Where you're prompting | What to know |