Docs

Coding agents

Say what you want built, the way you’d explain it to a teammate, and blabe pastes it into Claude Code, Codex, Cursor or any terminal. If you want, it presses Return for you too, but never at a shell prompt. This page is about blabe for Mac; On Windows covers the differences.

Quick start

  1. Install. Download blabe, or install it with Homebrew (below).
  2. Allow the microphone and Accessibility. blabe asks on first launch. Accessibility lets it hear the hotkey in any app and paste for you. See Permissions.
  3. Click into your agent’s prompt and dictate. Claude Code or Codex in a terminal, the Claude or Codex app, or the terminal in your editor. Your words land at the prompt about a second after you stop talking (1.0 s at the median on a Mac; how we measured).
  4. Send it. Press Return yourself, or let blabe do it: see Three ways to send.

Install with Homebrew

Working in a terminal already? Install blabe with Homebrew:

brew install --cask telenel/blabe/blabe

blabe is a 4.6 MB download and uses about 75 MB of memory while it waits (memory measured on blabe 1.0.21 for Mac).

AI cleanup: say it however it comes out

Thinking out loud is a good way to explain a bug and a bad way to write one down. With AI cleanup on (Settings → Dictation), blabe removes the “um”s, “like”s, “you know”s, repeats and false starts, and says each point once. It aims to keep every fact, number, name and “not”. The pill shows “Cleaned up” (“Rewritten” in the Aggressive style) when it changed something. AI cleanup: Aggressive, Standard or Off. Aggressive is the default for new installs. Updating keeps the setting you had. With it off, you get your words exactly as transcribed, and if cleanup fails, blabe pastes the original.

You say: “Okay, so the app is, like, crashing when you, when you open the settings, right? Like, every time. I open settings and it just crashes. Every single time I open settings, it crashes. So, yeah, can you look at that?”

blabe pastes: “The app crashes every time you open settings. Can you look at that?”

Three ways to send

  • Automatically. Turn on Send automatically to coding agents in Settings → Dictation. It’s off by default. blabe then presses Return after each paste into a coding agent. Every supported agent is selected at first; use the picker under the switch to narrow the list.
  • Once. In the default Hold mode, press Return before you let go of the hotkey. blabe finishes the recording, pastes and sends, even with automatic sending off. The pill shows ↩ while the send is armed. This needs the Accessibility permission.
  • Never. Leave both alone and blabe only pastes. You press Return yourself.

Where blabe presses Return

blabe presses Return only in these places, and only when it can tell a coding agent is in front of you.

Desktop apps. The Claude app and the Codex app. Return sends the message there.

Terminal apps. Terminal, iTerm2, Ghostty, kitty, WezTerm, Warp, Alacritty, Hyper, Tabby and Rio.

Editor terminals. The terminals inside VS Code, Cursor, Windsurf, Zed and JetBrains IDEs. Editor chat panels and source buffers never auto-send.

Agents blabe recognizes in a terminal. claude, codex, gemini, opencode, aider, amp, cursor-agent, copilot, goose, crush, qwen and droid. Only the exact command name matches, so codex-helper does not. blabe also finds these agents when they run as a Node, Bun, Deno or Python script.

Everywhere else, blabe pastes and you decide when to send.

It never presses Return at a shell prompt

In a terminal, Return runs whatever is typed. So blabe presses it only when all of this is true:

  • The tab that received the paste is running one of the agents above in the foreground.
  • The terminal shows fresh input after the paste, which tells blabe the paste reached that agent and not a shell.
  • Only one agent could have received the paste.

If blabe can’t tell, it pastes and stops. That includes a shell prompt, a terminal it can’t identify, and an app that has a shell terminal open in another tab, even when the paste went to its desktop composer. In tmux, blabe looks up the selected pane without changing anything, and skips the send if it can’t identify it or the pane is in copy mode.

Typing cancels the send

Typing after you let go, or starting another dictation, cancels the send. The transcript still pastes. If you switch apps before the text arrives, blabe copies it instead of pasting or sending. A retry from the menu follows your automatic-send setting and doesn’t reuse a one-time send. When your trial or subscription ends, new dictation stops until you subscribe or add your API key, so nothing new is pasted or sent.

Tips for dictating prompts

  • Teach it your stack. Add project, library and tool names in Settings → Words so blabe hears them right. A fix tells blabe what to paste when it hears something else, like “Supabase” when it hears “super base”. Fix Last Word in the blabe menu corrects what it just pasted.
  • Save prompts you repeat. In Settings → Snippets, save a short phrase and the text it stands for, such as your standing review instructions. Say the phrase on its own and blabe pastes the saved text exactly. Snippets stay on your computer.
  • Spell acronyms. Say “E-N-G-I” and blabe pastes “ENGI”.
  • Think out loud. With AI cleanup on, you can ramble through a bug report and paste a tidy one.

On Windows

blabe for Windows pastes into any app, terminals included. It presses Enter only in the Codex and Claude desktop apps’ message boxes, only after a confirmed paste, and only if you turn on sending in Settings → Dictation, where you choose which of the two apps receive sends. It’s off by default. To send once, in Hold mode press Enter before you let go of the hotkey: blabe finishes the recording, pastes and sends to either app, even with sending off, under the same checks. It never presses Enter in a terminal, an editor or any other app. Words, fixes and snippets work the same way. See blabe for Windows.

Add your own agent

To let blabe send in another command-line agent, add its exact command name in Terminal. Shells and generic interpreters such as zsh, ssh, tmux, node and python are refused.

defaults write com.montalvo.blabe extraAgents -array my-agent another-agent

To remove your additions:

defaults delete com.montalvo.blabe extraAgents