Full access is free during Beta. A paid subscription will be offered after Beta.

Windsurf — User Guide

Codeium IDE; Cascade agents.

Visit website
Freemium
Strengths
  • Cascade agents autonomously perform multi-step programming tasks
  • Have a deep understanding of the entire code base, not just the current file
  • Based on VS Code, low migration cost and plug-in compatibility
  • The free version has a generous quota and is suitable for individual developers.
  • Supports multiple AI models (Claude, GPT-4o, etc.)
Best for
  • End-to-end implementation of complex functionality (from requirements to code)
  • Refactoring and optimization of large code bases
  • Bug fixes and code reviews
  • Automatically generate test cases
  • Code documentation generation

Cascade agent usage

Cascade is a core feature of Windsurf that allows you to understand and modify code like a real developer colleague.

Scenario

Let Cascade implement a complete function

Prompt example
(Open the project in Windsurf, using the Cascade panel)

"Please add a user authentication function to my React project, requiring:
- Use JWT for authentication
- Contains login, registration, and logout pages
- Add routing protection (jump to login page if not logged in)
- Use React Context to manage authentication status
- Consistent with existing API style"
Output / what to expect

Cascade will:

  1. First analyze the existing code base structure and API style
  2. Create the required component files
  3. Modify routing configuration
  4. Add Context and Hook
  5. Update relevant existing documents The entire process is automated and every step is explained.
Tips

Cascade will actively read your code base and understand the project structure before starting to avoid conflicts with existing code.

Scenario

Fix complex bugs

Prompt example
"My app has a race condition when the user clicks a button quickly.
This results in inconsistent data status. Please help me find the problem and fix it. "
Output / what to expect

Cascade will:

  1. Search for relevant event handling code
  2. Identify the root cause of the race condition
  3. Propose a repair plan (such as using useRef for anti-shake, AbortController to cancel the request)
  4. Automatically modify related files
  5. Explain the principle of repair
Tips

The more specific the triggering conditions that describe the bug, the more accurately Cascade can locate the problem.

Starter & above

The rest of this guide

Additional scenarios and the full comparison table are included with Starter and above. Sign in with an eligible account to load them.

You're on the Free plan. Upgrade to Starter or higher to unlock the rest of this guide—additional scenarios and the full comparison table.

Loading full guide…