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.

MCP

MCP servers extend the agent’s capabilities.

Model selection

Select your desired model from the selection menu below the chat input.

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.

Access to Tools

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 25 tool calls per prompt. If the trajectory stops, simply type in continue and Cascade will resume from where it left off. Each continue will count as a new prompt.

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 collaboration

A unique capability of Windsurf and Cascade is that it is aware of your real-time actions.

You no longer necessarily need to prompt with context on your prior actions, as Cascade and Windsurf are already aware.

The following video shows how a recent variable name change was automatically detected within Cascade.

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 (Beta)

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.