Cascade allows us to expose AI Flows, a new way of coding with AI.

To open Cascade, press Cmd/Ctrl+Lclick the Cascade icon in the top right corner of the Windsurf window.

Selected text in the editor or terminal will automatically be included when Cascade is opened.

MCP

MCP servers extend the agent’s capabilities.

Model selection

Select your desired model from the selection menu below the Cascade conversation input box. A full list of the available models can be found here.

Write/Chat Modes

Cascade comes in two modes: Write and Chat.

Write mode allows Cascade to create and make modifications to your codebase, while Chat mode is optimized for questions around your codebase or general coding principles.

While in Chat mode, Cascade may propose new code to you. If you accept it, it will be added to your codebase.

Tool Calling

Cascade has a variety of tools at its disposal, such as Search, Analyze, Web Search, MCP, and the terminal.

It can detect which packages and tools that you’re using, which ones need to be installed, and even install them for you. Just ask Cascade how to run your project and press Accept.

Cascade can make up to 20 tool calls per prompt. If the trajectory stops, simply press the continue button and Cascade will resume from where it left off. However, each continue will count as a new prompt credit due to tool calling costs.

Revert to previous steps

You have the ability to revert changes that Cascade has made if you want to. Simply hover your mouse over the original prompt and click on the revert arrow on the right, or revert directly from the table of contents. This will revert all code changes back to the state of your codebase at the desired step.

Reverts are currently irreversible, so be careful!

Real-time awareness

A unique capability of Windsurf and Cascade is that it is aware of your real-time actions, removing the need to prompt with context on your prior actions.

Simply instruct Cascade to “Continue”.

Send problems to Cascade

When you have problems in your code which show up in the Problems panel at the bottom of the editor, simply click the Send to Cascade button to bring them into the Cascade panel as an @ mention.

Explain and fix

For any errors that you run into from within the editor, you can simply highlight the error and click Explain and Fix to have Cascade fix it for you.

Ignoring files

If you’d like Cascade to ignore files, you can add your files to .codeiumignore at the root of your workspace. This will prevent Cascade from viewing, editing or creating files inside of the paths designated. You can declare the file paths in a format similar to .gitignore.

Linter integration

Cascade can automatically fix linting errors on generated code. This is turned on by default, but it can be disabled by clicking Auto-fix on the tool call, and clicking disable. This edit will not consume any credits.

When Cascade makes an edit with the primary goal of fixing lints that it created and auto-detected, it may discount the edit to be free of credit charge. This is in recognition of the fact that fixing lint errors increases the number of tool calls that Cascade makes.

Sounds for Cascade

Play a sound when Cascade finishes a trajectory to let you know when it’s done. You can enable it via Windsurf Settings > Cascade > Enable Sounds for Cascade.

Sharing your conversation

This feature is currently only available for Teams and Enterprise customers. Currently not available to Hybrid customers.

You can share your Cascade trajectories with your team by clicking the ... Additional options button in the top right of the Cascade panel, and clicking Share Conversation.

Simultaneous Cascades

Users can have multiple Cascades running simultaneously. You can navigate between them using the dropdown menu in the top left of the Cascade panel.

If two Cascades edit the same file at the same time, the edits can race, and sometimes the second edit will fail.