← Back to Blog

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:

Where it struggles in an IDE:

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:

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:

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

  1. Download Voice Keyboard Pro from voicekeyboardpro.com and grant microphone and accessibility permissions.
  2. Choose a hold-to-talk hotkey that does not collide with your editor keybindings.
  3. 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.
  4. 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:

Keep typing:

Tips for Dictating Technical Prompts

Which Option Should You Pick?

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.