Short answer: Windsurf has no built-in voice dictation, and Microsoft's marketplace speech extension is not available in its extension registry. The best options are macOS or Windows system dictation for short prompts, or a system-wide dictation app like Voice Keyboard Pro that types polished text anywhere in the IDE.
Windsurf belongs to the new generation of AI-first code editors. Instead of typing every line yourself, you describe what you want in plain English to Cascade, its agentic AI panel, and the editor plans and writes the code. Which quietly changes what "coding speed" means: the bottleneck is no longer how fast you can type syntax, it is how fast you can explain intent.
And explaining intent is something humans do far better out loud. Most developers type at 60 to 80 words per minute on a good day, while everyone speaks at 130 to 150. When the main thing you write all day is prose prompts rather than code, dictation stops being an accessibility feature and starts being a straightforward productivity upgrade. The same logic applies to voice typing in the Cursor AI editor, and we have covered the general craft of dictating AI prompts on a Mac before. This guide is specifically about Windsurf: what works, what does not, and the best setup we know of in 2026.
The Catch: Windsurf Has No Built-In Dictation
First, the bad news. Windsurf itself ships no voice input. There is no mic button in Cascade and no dictation command in the palette.
The second piece of bad news is subtler. Windsurf is built on the same open-source foundation as VS Code, but like most VS Code forks it pulls extensions from the Open VSX registry rather than Microsoft's Visual Studio Marketplace. Microsoft's own speech extension is proprietary and, as of this writing, not available there. So the easy answer that works in VS Code ("install the official speech extension") simply is not on the menu in Windsurf.
That leaves three realistic routes: your operating system's built-in dictation, third-party editor extensions, or a system-wide dictation app that does not care which editor you use. Let us take them in order.
Option 1: macOS Built-In Dictation
If you are on a Mac, system dictation works inside Windsurf the same way it works in any text field. Enable it in System Settings under Keyboard, then press your dictation shortcut with the cursor in the Cascade input box and start talking.
What is good about it:
- It is free and already installed.
- It is fine for short, plain-English prompts ("add error handling to this function").
- On recent Apple silicon Macs, much of the processing happens on-device.
Where it struggles in an IDE:
- Technical vocabulary. It has no way to learn your function names, package names, or project jargon. Say "useAuthStore" and you will get three words and a coin flip on spelling.
- Pauses end the session. Thinking through a prompt mid-sentence is normal when describing a refactor; system dictation often shuts off while you think.
- Punctuation control. Auto-punctuation tuned for text messages produces odd results in long, structured prompts.
Verdict: a reasonable way to discover whether you like talking to Cascade, and a poor way to do it all day.
Option 2: Windows Voice Typing
On Windows, press Win + H with your cursor in any Windsurf text field and the system voice typing panel appears. The profile is similar to macOS dictation: free, built in, decent on conversational English, weak on identifiers and technical terms, and operated through a toggle you have to remember to switch off. For occasional prompts it is serviceable. For heavy Cascade use the correction overhead adds up quickly.
Option 3: Editor Extensions
Open VSX does host community speech-to-text extensions, and new ones appear regularly. The recurring trade-offs:
- Most require you to bring your own speech-recognition API key and configure it per machine.
- They only work inside the editor, so the terminal, your browser, your Git client, and Slack are all still keyboard-only.
- Quality and maintenance vary; an extension that breaks on the next editor update is a real possibility.
If you enjoy tinkering, this route can work. If you want dictation to be infrastructure rather than a hobby, the next option is the one we recommend.
Option 4: A System-Wide Dictation App (Our Pick)
The cleanest solution ignores Windsurf's extension situation entirely. Voice Keyboard Pro is a Mac menu bar app built on a hold-to-talk model: hold a hotkey, speak, release, and accurately punctuated text appears at your cursor. Because it types wherever the cursor is, it works in every part of Windsurf with zero integration:
- The Cascade panel, where you will use it most. Hold the key, describe the change you want in two or three sentences, release, and hit enter.
- The editor itself, for comments, docstrings, README sections, and TODO notes.
- The integrated terminal, including dictating Git commit messages in the terminal, which is one of the most satisfying voice workflows in a developer's day.
- Everything outside Windsurf too: the pull request description in your browser, the standup message in Slack, the issue comment in your tracker.
Three things make this materially better than the built-in options for IDE work:
Hold-to-talk fits how prompts are written. Describing a refactor involves pausing to think. With hold-to-talk, the recording lasts exactly as long as your thumb says it should; there is no silence timeout deciding your prompt was finished before you were.
Smart Vocabulary learns your codebase's language. Voice Keyboard Pro's personal dictionary supports replacement rules, so you can teach it once that "use auth store" should come out as useAuthStore, that your package is called what it is actually called, and that your company's internal service names are spelled the way they are spelled. For technical dictation, this is the difference between a tool you trust and a tool you babysit.
The transcription engine handles natural speech. Voice Keyboard Pro's advanced AI transcription is built for conversational, thinking-out-loud speech, complete with punctuation, so prompts come out reading like written English rather than a telegram.
A note on privacy, since prompts often describe proprietary code: our servers store only operational pings. No audio and no transcript content are stored on our servers.
One more developer-relevant bonus: Voice Keyboard Pro also includes Meeting Mode, with speaker detection and AI-generated notes, plus calendar meeting detection that knows when a meeting is starting. If your day mixes Cascade sessions with standups, sprint planning, and architecture reviews, the same app that types your prompts can turn those meetings into notes, so decisions actually make it from the call into the codebase.
Setting It Up With Windsurf
- Download Voice Keyboard Pro from voicekeyboardpro.com and grant microphone and accessibility permissions.
- Choose a hold-to-talk hotkey that does not collide with your editor keybindings.
- Open Windsurf, click into the Cascade input, hold the key, and describe a task: "Add input validation to the signup form, show inline errors under each field, and write a test for the empty-email case." Release.
- Spend five minutes adding your project's recurring identifiers and jargon to Smart Vocabulary. This step pays for itself by the end of the first day.
There is a free tier with daily limits, so you can run it against a real day of Cascade prompting before deciding anything. Pro is $4.99 a month or $34.99 a year.
What to Dictate in Windsurf (and What Not To)
Voice is not the right input for everything in an IDE. The pattern that works is simple: dictate prose, type syntax.
Dictate:
- Cascade prompts. The big one. Spoken prompts also tend to be better prompts: people naturally include more context and intent when talking than when typing, because the words are cheap.
- Code review feedback. Explaining why a change matters is prose; you will write more helpful comments at speaking speed.
- Commit messages and PR descriptions. The body of a good commit message is exactly the kind of two-paragraph explanation nobody wants to type.
- Documentation and comments. Docstrings, READMEs, architecture notes. The dread of writing docs is mostly the dread of typing them.
- Rubber-duck planning. Talk through the approach into a scratch file before you prompt. You will often find the design flaw before Cascade does.
Keep typing:
- Actual code, where every character is load-bearing. That is what Cascade generates anyway.
- Precise single-symbol edits, where clicking and typing is faster than describing.
- Anything in a shared office you would rather not broadcast.
Tips for Dictating Technical Prompts
- Lead with the goal, then the constraints. "Make the dashboard load faster. Specifically, paginate the transactions query and cache the user profile call." Spoken structure becomes prompt structure.
- Refer to code by role when the exact name does not matter. "The auth middleware" usually gives the AI enough to find the right file, and it survives transcription perfectly.
- Add the names that do matter to your vocabulary. If a term will come up weekly, teach it once instead of correcting it forever.
- Speak in chunks. Hold, deliver one complete thought, release, read it, continue. Short cycles keep errors small and easy to spot.
- Do not perform punctuation. Modern transcription handles natural sentence rhythm; talking like a human produces better text than dictating like a fax machine.
- Dictate the second draft of your prompt, not the first. If a task is gnarly, talk through it once in a scratch note to untangle your own thinking, then dictate the clean version to Cascade. Two short takes beat one rambling one.
Which Option Should You Pick?
- You prompt Cascade a few times a day: built-in macOS dictation or
Win + His fine. Start there. - You live in Cascade and write prompts constantly: a system-wide hold-to-talk app is the setup that holds up, because of the vocabulary problem alone.
- You want voice only inside the editor and enjoy configuration: browse Open VSX for a speech extension and bring your own API key.
- You switch between Windsurf, a browser, a terminal, and Slack all day: system-wide wins by definition; it is the only option that follows you.
Frequently Asked Questions
Does Windsurf have built-in voice dictation?
No. As of this writing, Windsurf ships no native voice input, and because it uses the Open VSX extension registry, Microsoft's proprietary speech extension for VS Code is not installable in it. Voice input has to come from the operating system, a community extension, or a system-wide dictation app.
Can I dictate actual code in Windsurf?
You can, but you mostly should not. Dictating syntax character by character is slower than typing it. The winning division of labor in an AI IDE is to speak the intent and let the AI write the syntax, which is precisely what Cascade is for.
Will dictation handle camelCase names like handleSubmit?
System dictation generally will not. With Voice Keyboard Pro, add a replacement rule in Smart Vocabulary, and a name you teach it once will come out correctly formatted every time after that.
Will dictation work in Windsurf's integrated terminal?
Yes, if you use a system-wide app. The integrated terminal is just another text field with a cursor, so hold-to-talk dictation types into it like anywhere else. Shell commands themselves are usually faster typed, but commit messages and long descriptions you would rather say than spell all work well by voice.
Does this work the same in Cursor or VS Code?
Yes. A system-wide dictation app types at the cursor, so the same hotkey and the same vocabulary work in Windsurf, Cursor, VS Code, and any other editor. Our Cursor voice typing guide covers the Cursor-specific details.
The Bottom Line
Windsurf turned programming into a conversation, then left you typing your half of it. The built-in dictation on macOS and Windows will get you through a handful of prompts a day; for everything beyond that, the timeouts and the mangled identifiers cost more than they save.
In an AI IDE you are no longer paid to type code — you are paid to explain what the code should do. Explaining is a job for your voice.
A system-wide hold-to-talk app gives you one habit that covers Cascade, the editor, the terminal, and everything around them. Try Voice Keyboard Pro free, open Cascade, hold the key, and describe your next feature out loud. The prompt will be longer, clearer, and finished sooner than the one you would have typed.