Overview
Cascade allows us to expose AI Flows, a new way of coding with AI.
To open Cascade, press Cmd/Ctrl+L
click the Cascade icon in the top right corner of the Windsurf window.
Quick links to features
Image Upload
Add images to your prompt to be referenced in Cascade’s suggestions.
Web Search
Search the web for information to be referenced in Cascade’s suggestions.
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.
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.
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
.