FreeFlowDownload
Use cases · Use case

Voice dictation in the terminal

By Yiftach FreemanUpdated 3 min read

FreeFlow pastes into whatever is in front, and a terminal is in front like anything else: hold ⌥ at the prompt, speak, release, and the text is at the cursor without a newline, so nothing runs until you press Enter. It works the same in iTerm2, Terminal.app, Warp and Ghostty, and in the prompt of Claude Code, Codex or any other CLI agent.

How the paste behaves

FreeFlow writes a take by putting it on the clipboard, sending ⌘V to the frontmost app, and restoring your clipboard about a second and a half later. A terminal receives that like any paste. The take has no trailing newline, so a dictated command sits at the prompt waiting for Enter; nothing you say is ever executed on its own. Terminals with bracketed paste on (iTerm2 and most modern ones) treat the whole take as one paste even if the model produced a line break.

What a terminal is good for

Setting up

  1. Give the terminal no special permissionFreeFlow needs Accessibility (to paste) and Microphone; the terminal needs nothing. Unlike Claude Code's /voice, which asks for microphone access for the terminal app itself, FreeFlow's microphone is its own.
  2. Use a Code modeParakeet V2 or V3, formatting off so flags and identifiers are left exactly as heard, filler removal on. See modes.
  3. Fill the dictionary with your commandskubectl, docker compose, pnpm, terraform, the names of your services. Each one once, as a replacement (heard-as → spelling), which rewrites exactly on Parakeet as well as Whisper.
  4. Hold ⌥ at the promptSpeak, release, read what landed, press Enter. For a long agent prompt, ⌥Space toggles hands-free recording.

Claude Code, Codex and friends

A CLI agent's prompt is where most of the prose in a developer's day now goes, and it is the surface where dictation pays off fastest. Hold ⌥, describe the task in full sentences, release, Enter. When Claude Code stops to ask you something — which approach, approve this plan, allow this command — FreeFlow's Claude Code bridge shows a card you can answer out loud without switching windows. Codex and Aider have no equivalent hook system, so with them FreeFlow is dictation only.

Quirks

Questions people ask

Will dictation run a command by accident?

No. The take is pasted without a newline. Nothing runs until you press Enter.

Does it work in iTerm2?

Yes, and in Terminal.app, Warp, Ghostty, Alacritty, kitty and WezTerm. Anything that accepts a ⌘V paste.

Does it work in Claude Code's prompt?

Yes — and FreeFlow also answers Claude Code's plan, question and permission cards by voice through its hook. That part is Claude Code only.

What about Windows Terminal or Linux?

FreeFlow is macOS only, on Apple Silicon.

Try FreeFlow free for 14 days$99 once, three MacsNo card, no account. macOS 14+ · Apple Silicon.
Download now