How to Talk to Windsurf by Voice on a Mac
Windsurf is fast to type in, but describing a refactor or a new feature out loud is faster still. With the right on-device dictation layer, you can prompt Cascade, write commit messages and describe code changes just by talking, without your audio ever leaving your Mac.
Key takeaways
- Windsurf has no full built-in dictation engine, so you add voice at the system level.
- A system-wide tool types into the Cascade chat, the editor and the terminal alike.
- On-device speech recognition keeps prompts and source code private on the Mac.
- Speak your intent in plain language and let Windsurf's AI generate the exact syntax.
Why voice fits Windsurf so well
Windsurf's Cascade agent is driven by natural-language prompts. You are not typing raw syntax into it, you are describing what you want: "add error handling to the upload route and log failures." That is a sentence, not code, and sentences are exactly what dictation is good at. Most people speak around three to four times faster than they type, so a long, detailed prompt that would take a minute to type is a ten second sentence out loud.
The catch is that Windsurf itself does not ship a full dictation engine. The clean solution is to add voice at the operating system level so it types into every part of the app: the Cascade panel, the code buffer, the integrated terminal and the commit box. If you are new to the idea, our overview of how to code by voice on a Mac covers the general workflow that this guide applies specifically to Windsurf.
What you need before you start
The setup is short. You need Windsurf installed on an Apple Silicon Mac, a dictation tool that works system-wide, and a quiet enough spot for the mic to hear you clearly. You do not need a studio setup: the built-in MacBook mic is fine for prompts, though if you dictate all day it is worth reading whether you need a good mic to dictate on a MacBook.
For privacy-sensitive codebases, the dictation tool matters most. A cloud dictation service streams your microphone to a server, which means your prompts, and sometimes snippets of code you read aloud, leave the machine. An on-device tool like BlaBlaType runs the speech model locally, so nothing is uploaded. That distinction is the whole reason it belongs next to your editor.
Set up voice for Windsurf in four steps
Install an on-device dictation app
Download BlaBlaType for macOS and grant microphone and accessibility permissions when prompted. Accessibility access is what lets it type into Windsurf like a keyboard rather than into a separate window.
Pick a push-to-talk shortcut
Choose one global shortcut to start and stop dictation. A single key you can reach without looking, held while you speak, keeps you in flow while your hands stay near the keyboard.
Click into Windsurf's Cascade chat
Place your cursor in the Cascade prompt box, the editor, or the terminal. Whatever field has focus is where your spoken words will be typed, so aim before you speak.
Speak your prompt, then send
Hold the shortcut, describe the change in plain English, release, and the cleaned-up text appears. Read it once, then press enter to hand it to Cascade.
Talking to Cascade versus dictating literal code
There are two different jobs here, and it helps to treat them differently. Prompting Cascade is prose: "extract this component into its own file and add prop types." Dictation shines here because you are speaking naturally, and on-device AI cleanup removes filler words, fixes punctuation and hands Cascade a clean instruction. Windsurf then writes the actual syntax. The official AI editor documentation from tools in this space, and Anthropic's Claude Code docs, both lean on the same idea: describe intent, let the model produce the code.
Dictating literal code, character by character, is the harder case for any voice tool because symbols and camelCase names are not how people speak. The practical move is to let the AI write the syntax from your description, and to lean on a custom dictionary for the names, libraries and jargon you repeat, so "use pyproject" or a specific class name transcribes correctly every time. The same approach works when you talk to ChatGPT with voice on a Mac for planning or debugging.
Dictate into Windsurf, privately
Prompt Cascade, write commits and describe changes by voice. On-device, system-wide, no card needed for the trial.
Download for macOSWhy on-device matters for a code editor
Your editor sees more sensitive material than almost any other app: proprietary logic, API keys in config, client project names. When you speak a prompt that references those things, a cloud dictation tool would send that audio off your machine. An on-device approach keeps the entire loop local: the speech model, the AI cleanup and the resulting text all stay on the Mac, and the audio is discarded after transcription. It also means dictation keeps working on a plane or in a locked-down network. If you want the deeper comparison of local tools, our writeup on a Superwhisper alternative for Mac lays out how the on-device options stack up. You can review the plans on the pricing page before you commit to anything.
Voice methods for Windsurf compared
| Method | On-device | Types into Cascade | AI cleanup |
|---|---|---|---|
| BlaBlaType | Yes | Yes | Yes |
| Apple Dictation | Mixed | Yes | No |
| Cloud dictation service | Cloud | Yes | Yes |
| Transcribe-a-file tool | Yes | Paste only | No |
The pattern is the same as with any editor: system-wide tools type directly into Windsurf, on-device tools keep your work private, and only some do both while also cleaning up your speech. That intersection, private plus system-wide plus AI cleanup, is the sweet spot for talking to an AI code editor day in and day out.
Frequently asked questions
Does Windsurf have built-in voice input on Mac?
Windsurf does not ship a full system dictation engine of its own. The reliable way to talk to Windsurf on a Mac is to run a system-wide dictation tool that types into the Cascade chat and the editor like a keyboard, so your words land wherever your cursor is.
Can I talk to Windsurf by voice without sending audio to the cloud?
Yes. A dictation app that runs speech recognition on-device transcribes your voice locally on the Mac and never uploads the audio. BlaBlaType keeps every word on the device, so your prompts and code stay private.
How do I dictate code and symbols into Windsurf?
For prose prompts in the Cascade panel, plain dictation works well. For literal code, speak the intent in natural language and let Windsurf generate the syntax, or use a custom dictionary to teach the dictation app the names and jargon you use most.
Is voice faster than typing for coding prompts?
For describing what you want in the Cascade chat, yes. Most people speak around three to four times faster than they type, so long prompts and refactor requests are quicker to say than to type out by hand.
Will voice dictation work in other Mac apps too?
Yes. A system-wide dictation tool types wherever your cursor is, so the same shortcut works in Windsurf, your terminal, email, Slack and any other Mac app or text field.