How to Use Windsurf with Voice Commands - SpeakEasy Guide

Windsurf is an AI-powered IDE that revolutionizes how developers write code. When combined with SpeakEasy's voice-to-text capabilities, you can achieve true hands-free coding. This guide shows you how to set up and use SpeakEasy with Windsurf.

What You'll Need

Windsurf IDE installed
SpeakEasy (free tier or paid)
A microphone (built-in or external)
5 minutes to set up

Step 1: Install SpeakEasy

Download SpeakEasy from our website
Run the installer and follow the setup wizard
Grant microphone permissions when prompted
Launch SpeakEasy

Check out our features page to see all the capabilities SpeakEasy offers.

Step 2: Configure SpeakEasy for Windsurf

Open SpeakEasy Settings
Select "Agent Chat" mode (optimized for Windsurf)
Set your hotkey (default: Ctrl+Shift+Space)
Optional: Add your OpenAI API key for faster transcription

Step 3: Using Voice Commands in Windsurf

Adding Files to Context

Say: "reference main.ts" Result: "@main.ts" is automatically inserted with Tab completion

Say: "add utils.ts and helpers.ts" Result: "@utils.ts @helpers.ts" are inserted

Dictating Code

Say: "function get user by id" Result: "function getUserById" (auto-formatted)

Say: "const user equals await fetch" Result: "const user = await fetch" (auto-formatted)

Using Smart Modes

Agent Chat Mode (default for Windsurf):

Optimized for natural language prompts
Automatic @ syntax for file references
Perfect for giving instructions to Windsurf's AI agent

Example: "Add error handling to the login function"

SpeakEasy converts to: "Add error handling to the login function"
Windsurf's AI understands and implements the change

Pro Tips

Tip 1: Use Natural Language

Instead of: "function get user by id with parameters user id string" Say: "function get user by id" SpeakEasy will auto-format it correctly.

Tip 2: Reference Files Naturally

Instead of: "at sign main dot ts" Say: "reference main.ts" SpeakEasy converts to: "@main.ts"

Tip 3: Combine Voice with Keyboard

Use voice for high-level instructions
Use keyboard for precise edits
This hybrid approach is fastest

Tip 4: Use Silence Detection

SpeakEasy automatically stops recording after 8 seconds of silence. Pause between sentences for better accuracy.

Performance Metrics

Recording to insertion: 6.5 seconds average
Transcription accuracy: 95%+ (with OpenAI Whisper)
File reference detection: 100+ file extensions supported

Troubleshooting

Voice not being recognized

Check microphone permissions in Windows Settings
Test microphone in Settings > Sound > Input
Try adjusting microphone volume

@ syntax not appearing

Ensure you're in Agent Chat mode
Say the file name naturally (e.g., "reference main.ts")
Check that the file exists in your project

Slow transcription

Upgrade to Pro tier for faster processing
Add your OpenAI API key for instant transcription
Check your internet connection

Next Steps

Explore other modes: Email, Document, Outline
Try the Ultimate tier for local Whisper processing
Learn about Cline AI Agent integration

Conclusion

Combining Windsurf with SpeakEasy creates a powerful hands-free coding experience. You can now dictate code, add files to context, and give instructions to Windsurf's AI agent entirely by voice.

Start with the free tier (100 transcriptions/month) and upgrade when you need more power.

Ready to try it? Download SpeakEasy and start coding hands-free today! Check our pricing page to find the perfect plan for you.