Voice dictation in the terminal
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
- Prompts to CLI agents. Claude Code, Codex, Aider, Gemini CLI: their prompt is a text field, and a spoken prompt is longer and better than a typed one. For Claude Code specifically, FreeFlow also answers the agent's questions by voice.
- Commit messages.
git commit -m "then hold ⌥, speak the message, release, close the quote. - Long flags and paths you know by heart but hate typing. The dictionary spells
kubectl,--dry-run, your bucket names. - Not: rapid-fire short commands. Typing
lsbeats saying it. Dictation wins when there are more than about eight words.
Setting up
- 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. - Use a Code modeParakeet V2 or V3, formatting off so flags and identifiers are left exactly as heard, filler removal on. See modes.
- Fill the dictionary with your commands
kubectl,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. - 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
- Vim and other modal editors receive the paste in whatever mode they are in. Press
ifirst, or use:set pastefor a long take. - tmux inside a terminal passes the paste through; nothing special needed.
- Warp's AI block and Ghostty both take the paste as typed text at the cursor.
- A terminal that swallows ⌘V (rare, usually a custom keymap) leaves the take on your clipboard for 30 seconds — paste it with the terminal's own shortcut.
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.