New Model

Gemini 2.5 Pro (Beta)

• Gemini 2.5 Pro is now available in beta!
• Gemini 2.5 Pro takes 1x user prompt credits on every message and 1x flow action credits on each tool call
• Available for users Free and Pro Plans
• Currently experiencing high-demand and working to increase capacity

Fixes

• Fixes to "Remote - SSH" extension, including custom SSH binary path setting

Patch Fixes

Fixes

• Fixes for Cascade, which now better respects User-Defined Memories
• Improvements for Browser Previews
• Fixes for a few Cascade layout issues impacting icons

Windsurf Tab

New Windsurf Tab Experience

• Rolled up Autocomplete, Supercomplete, Tab to Jump, and Tab to Import into one experience called Windsurf Tab
• Windsurf Tab runs a larger and higher quality model, increasing contextual awareness, quality, and speed

Context Improvements

• Completions now use more signals including recently viewed files, terminal commands and outputs, Cascade conversations
• Optional clipboard as context for completions (default off, opt-in via Advanced Settings)
• Expanded context length, including more signals to improve completions

Quality Improvements

• Increased precision choosing between Autocompletes (insertions) and Supercompletes (edits)
• Higher recall and more than double the jump distances for Tab to Jump from previous versions
• Improved indenting and spacing for next-line suggestions

Speed Improvements

• Added predictive triggers, leading to consecutive completions after your previous completion or tab to jump
• Increased server capacities and improved inference speeds
• Improved networking, leading to reduced network latencies
• Tab to Import shows quicker and applies more reliably

Tab UX Improvements

• Accepted completions are highlighted green (can be disabled via Advanced Settings)
• Tab to Jump and Tab to Import widgets have a refreshed, more visible UI
• Tab to Jump and Tab to Import widgets are clickable

Misc Improvements

• More reliable credit discounting for lint-fixing edits in auto-fix lint mode
• In-IDE Terminal commands are now used as context for Cascade
• The Tab key works to accept intellisense in the Debug Console
• Improved Cascade diff review UX
• Fixes to low credit warnings
• Fixes to Autocomplete Speed settings
• Improvements to Quick Settings dropdown
• Improved CPU and memory usage
• Add Neon database as a Model Context Protocol template

Patch Fixes

Fixes

• Fixes crashes around MCP misconfiguration
• Fixes around web search for Sonnet 3.7
• Fixes for proxy settings

Patch Fixes

Patch Fixes

• Fixes to Windsurf Previews where certain routes would not load.
• Fixes to open Cascade shortcuts (cmd/ctrl+shift+L)
• Re-added new settings configs to new settings panel (proxy settings, index size)

Windsurf Previews, Auto-Linter, and new MCP servers

Windsurf Previews (Beta)

• Cascade will now let you preview locally run websites in your IDE or in your browser.
• You can select React and HTML element(s) within the preview to send to Cascade as context.
• This context will be included in your Cascade conversation so you no longer need to copy-paste or send screenshots.
• You can also send console errors to Cascade as context.
• A Windsurf Preview can be activated by asking Cascade to start your web application or through the Website tools icon in the toolbar above conversation input.
• A preview can be shown in the IDE or in a new browser on Chrome, Arc, and Chromium based browsers.
• Can be turned off via Windsurf Settings.
• Available to all plans and costs no credits.

Cascade Auto-Linter

• Cascade now auto-lints proposed code changes it has made.
• If an output from a code edit proposes a lint error, Cascade will automatically fix it in a subsequent edit.
• Fixes to lints are available to all plans and the Cascade edit step to fix the lints costs no credits.
• For example, if Cascade made 4 lint errors in a step, Cascade will try to fix the 4 lint errors at no credit charge.
• Disclaimer: The LLM decides when its purely fixing lints and when to not charge a credit.
• Can be turned off via Windsurf Settings.
• Available to all plans.

New MCP Server Integration

• You can now setup Cascade to make tool calls to trusted MCP servers.
• A list of common MCP servers can be found in the new Windsurf Settings Page.
• Brand new UX to make it easier to add and configure MCP servers.
• A user-configurable JSON is still available via the Settings page.
• Available to Pro and Pro Ultimate plans, with support to Teams and Enterprise plans coming soon.

Tab-to-Import

• In-line suggestions to import the necessary dependencies when you write code.
• Windsurf will display a suggestion to import the necessary dependencies in your file.
• The suggestion can be accepted just like an auto-complete suggestion via tab.
• Available to all plans.

Suggested Actions

• Cascade now gives suggested actions to help you complete your task.
• If Cascade asks a question or a set of next potential steps, you can select the one you want to proceed with with a suggested action.
• Available to all plans.

Drag and Drop Files as Context

• Cascade now allows you to drag and drop files from the File Explorer into Cascade as context
• Works with all system file types.
• Available to all plans.

Model Option Admin Control

• For teams and enterprise plans, admins can select which models are available to its team.
• As a member of a team, you will only see the models that are available to your team unless enabled by your admin.

Improvements to Claude Sonnet 3.7

• Claude Sonnet 3.7 is now available as a new model in Command dropdown.
• Improvements to its performance and quality with respect to tool calls and flow actions.

Support For Windows ARM

• Beta support for Windows ARM for Windsurf.
• Report feedback to codeium.com/support.

Misc

• Brand new Quick Settings Panel UI and Advanced Settings View.
• Setting to allow Cascade to access .gitignore files.
• In-product support for user referrals.
• Windsurf directory - a curated list of example rules by the Windsurf team that can guide Cascade to better understand you and your codebase, resulting in higher quality responses. View the directory

Patch Fixes

• Fixes crashes due to permissions errors on Ubuntu 24.04

Patch Fixes

Patch Fixes

• Improvements for Cascade credit usage for Claude 3.7 Sonnet
• Once updating, try running all future credits in a new conversation
• MCP fixes for incorrectly formatted MCP tools in JSON
• Better MCP Error Handling
• Fixes for some App Icon issues for Mac users
• Option for Cascade to view / edit .gitignore files

Claude 3.7

New Cascade Models

• Cascade now has a new premium model available: Claude 3.7 Sonnet

  • Takes 1.0 user prompt credits on every message and 1.0 flow action credits on each tool call
  • Support for Claude 3.7 Sonnet ships with Thinking, with a 1.5x multiplier on credit cost.

• [ROLLING] Cascade supports GPT-4.5 as a beta model

  • Due to costs, rate limits, and quality from early testing, we will be rolling it out to users incrementally.

Patch Fixes

Fixes

• Some fixes for Cascade write tools
• Fixes some bugs around user message cancellation
• Fixes around enabling Cascade Base when low on credits
• Catches some error cases around auth entry login and surfaces error message to user

Model Context Protocol, Custom App Icons, and Tab to Jump

Model Context Protocol

• Cascade now supports Model Context Protocol (MCP)
• You can setup your Cascade conversation to make tool calls to user-configured MCP servers
• You can setup MCP by clicking on the hammer in the Cascade input tool bar
• Available to all individual plans
• Every MCP tool call costs one flow action credit, regardless of the execution result

New Customizable App Icons

• You can now change Windsurf's App Icon (Beta & Mac Only)
• Paying users can choose between Classic, Blueprint, Hand-drawn, and Valentine options
• Updates across entire operating-system, though a restart is required for a system-wide change to take effect
• Available to all paid user plans
• Customization coming to Windows and Linux soon

Improvements to Completions

• Fully releasing Tab to Jump, an enhanced editor experience that predicts the location of your next edit and navigates you there with a tab keypress
• Background predictive completions for improved latencies
• Performance and quality improvements for supercomplete and autocomplete

Cascade Turbo Mode

• Cascade has a revamped "Turbo Mode" that allows Cascade to auto-execute terminal commands, unless specified in deny-list
• Available to all individual plans

Cascade Drag and Drop Image Support

• Cascade now allows you to drag and drop images into Cascade
• Works from system files or screenshots

Credit Visibility

• Cascade now shows many credits an action took.
• You can see the number of credits consumed by mouse hovering over the completed action in Cascade.

Misc

• Fixes to some bugs in Cascade terminal commands.
• Command steps now include information about the auto execute behavior.
• Fixed a bug where Cascade panel would always open on reload, even if the user disabled it in their settings
• You can @-mention terminal text with Cmd/Ctrl+L feature. New selection popup appears.
• All @docs options now show in a scrollable view instead of limiting the results.
• @docs now includes even more options including Vercel, Bun, Supabase, and more

Patch Fixes

Fixes

• Fixed issues with partial credits when transitioning to flex credits

Patch Fixes

Fixes

• Fixed tool calls errors, specifically around invalid tool calls by the model
• Fixed Web Search setting unavailable message option

New Models

• Cascade now has a new premium model available: Gemini 2.0 Flash
  • Gemini 2.0 Flash takes 0.25 user prompt credits on every message and 0.25 flow action credits on each tool call

New Models: DeepSeek-R1, DeepSeek-V3 and o3-mini

Models

• Cascade now has new premium models available: DeepSeek-R1, Deepseek-V3 and o3-mini
  • Deepseek-V3 and Deepseek-R1 are available to users on Pro and Pro Ultimate Plans
  • Deepseek-V3 takes 0.25 user prompt credits on every message and 0.25 flow action credits on each tool call
  • DeepSeek-R1 takes 0.5 user prompt credits on every message and 0.5 flow action credits on each tool call
  • o3-mini is available to all users on paid plans
  • o3-mini takes 1 user prompt credit on every message and 1 flow action credit on each tool call

Fixes

• Further fixes to input lag in long Cascade conversations
• Fixed a bug where Cascade panel would always open on reload, even if the user disabled it in their settings
• @docs has more options to choose from
• Fixed Tab to Jump Quick Setting configuration
• Added support for drag and drop images into Cascade

Quick Updates

Improvements

• Cascade Web search now includes the website description and uses page rank to determine relevance
• Improvements to Cascade Auto-Generated Memories (Beta)

Fixes

• Fixed input lag in long Cascade conversations
• Increased precision when Cascade makes code edits
• Fixed issues around Cascade edits with .gitignore files
• Fixed Tab to Jump Quick Setting configuration

Cascade Memories, Web Search and Docs

Web and Docs Search

• Cascade can now search the web! There are a couple of ways to use this:
  • Automatically: Simply ask a query that needs a live internet search and Cascade will trigger web search automatically.
  • URL Input: Paste in a URL and Cascade will use your URL as context (works well with blog posts, docs, articles, public GitHub files, etc.).
  • @web: If you prefer to explicitly ask Cascade to search the web, use the @web command.
  • @docs: Cascade can search through some popular documentation sites, including Windsurf's own help docs!
• Web tools like search and URL reading can be enabled and disabled via the Windsurf Settings panel in the bottom right of your status bar.
• A web search is 1 flow action credit and the resulting URL page reads are additional credits.

Cascade Auto-Generated Memories

• Cascade can now automatically generate memories to retain context between conversations
• You can prompt Cascade to create a memory at any time if you want it to remember key context
• Memories are visible in the Memories Panel, which is accessible when Cascade makes a memory or through the command palette
• Memories can be deleted from the Memories Panel
• Memories do not cost any flow action credits to generate

Improvements to Dev Container Support (Beta)

• Dev Container support for Windows is now in beta
• UI Tweaks to Dev Container workspace labels
• Registers a command to reopen the current Dev Container workspace locally, enabling a switch from Dev Container to local workspace
• "Attach to Running Container" Feature available for any Docker container
• Added functionality for streaming Dev Container CLI output in real-time to show progress
• Fixed buffer overflow issues
• Dev Containers respect remoteUser configuration from devcontainer.json and container metadata

Fixes

• Fixed a bug where intellisense's auto-selected option would be sometimes be chosen incorrectly
• Fixed a bug where pressing Ctrl/Cmd + z after a diff hunk rejection would undo editor changes made immediately before the rejection
• Fixed a bug where rejecting the output of "Add docstring" breadcrumbs button would leave an extra newline
• Fixed a bug where in-editor diff decorations would not be correctly synced with Cascade after reverting to a past step
• Fixed a bug where renaming, moving, or deleting a file with an active Cascade diff would cause the changes overview popover to freeze on subsequent steps
• SSH Agent forwarding for Dev Containers on Mac and Linux
• Fixed bugs in Cascade's find tool, hopefully reducing errors in Cascade tool usage
• Performance improvements with Cascade and better visibility into errors
• Overall improvements to how Cascade will respect Rules and Auto-Generated Memories
• Fixed a rare bug where Reject All button in changes overview popover would revert all changes but not dispose of diff zones
• Fixed several sources of crashes that were preventing some users from authenticating
• Fixed a bug where using the at mention command in Cascade would crash the panel

Misc

• Cascade can now run commands natively in the IDE's terminal
• Cascade now proceeds without stopping when editing unsaved files in write mode
• Performance upgrades to Supercomplete, with more expressive inline rendering capabilities
• Added a per-file button in the Problems Tab tree view (the default) to send the file's problems to Cascade as an @-mention
• Added an Explain And Fix Problem button in error hover popup, and a shortcut (⌘/Ctrl + shift + .), which opens a new Cascade conversation instructing Cascade to explain and fix the problem
• Windsurf OAuth App for GitHub
• Keyboard shortcuts for accepting/rejecting the focused hunk of a Cascade diff (⌥/Alt + Enter and ⌥/Alt + Shift + Backspace by default) are now shown on the focused hunk
• Auto-focus the first hunk when opening a file with a Cascade diff

Patch Fixes

Fixes

• Fixed Cascade's Chat Mode sometimes not giving an "Apply" button
• Dev Container Stability Improvements
• Some Fixes for Cascade Flow Actions on Windows users

Patch Fixes

Fixes

• Fixed text wrapping layout bugs in Cascade
• Fixed a bug where "Show Logs" did not read the correct path

Quick Updates

Product Improvements

• Added a "Send to Cascade" button in the Problems tab
• Autocomplete and supercomplete show up regardless of intellisense.
• You can now see your plan on the Status Bar, with usage information on mouse hover
• Improvements to the onboarding flow
• Ability to download Windsurf Logs to help with support tickets

Fixes

• Fixed a bug for Cascade unable to apply its proposed code edits in chat mode on Windows
• Fixes autocomplete speed slowdowns affecting some users
• Bug fixes and stability improvements

Cascade Memories

Cascade Memories

• You can configure rules for Cascade Memories to follow. For example, you can use rules to specify if you want Cascade to respond in a certain language, communicate in a specific style, or use a specific API
• Rules can be found in the Windsurf Quick Settings panel by clicking on "Windsurf Settings" on the status bar
• Global rules are rules that will be applied to Cascade in all workspaces
• Workspace rules are rules that will be applied to Cascade in the current workspace
• More information can be found on our docs.

Cascade Auto Run Commands

• Cascade can now automatically detect to run certain terminal commands if it deems safe to do. This option is checked off by default and can be enabled in the Settings page, accessible in the top right dropdown. This only affects Cascade responses by premium models
• Supports an allow list and deny list of commands for Cascade to run. Allow list always accept the command and deny list always requests for permission to run a command.
• More information can be found on our docs.

Extensions

• WSL support is now in beta
• Bug fixes and improvements to devcontainer support, notably on Mac
• Updates to Windsurf Pyright

Misc

• Added Cascade undo/redo for full-file accept/reject and workspace-wide accept/reject all
• One-time check to install Windsurf Pyright if Python found

Patch Fixes

Misc

• Fixes for some crashes for some users
• Fixed bug where changing Cascade models would toggle the mode to Chat only

Usage Transparency

Usage Transparency and Pricing

• Rolling out updated usage and pricing system for Windsurf. See pricing for details
• Quick settings panel now additionally shows current plan usage, with information on trial expiry, next refresh cycle, and links to upgrade
• Introduction of new "Legacy Chat" mode in Cascade that activates when users run out of Flow Credits. This mode is limited compared to Cascade's normal capabilities, but does not require any Flow Credits to use
• View Cascade usage in the settings panel. Learn more about viewing Cascade usage here.

Cascade Image Uploads

• Cascade image uploads are no longer limited to 1MB

Improved Language support for Python

• Added feature-rich language support for Python with Windsurf Pyright. Windsurf Pyright is a Pylance alternative

Misc

• Importing from other VS Code-based IDEs now imports snippets alongside settings
• AI-related Keybindings can be viewed and configured in the quick settings panel
• Added clearer error messages and debug handling for users experiencing auth issues

Image Upload

Upload Images to Cascade

• Cascade now supports uploading images on premium models
• Ask Cascade to build or tweak UI on image upload

New keybindings

• Keybindings to navigate between changes in a Cascade diff (⌥/Alt + j and ⌥/Alt + k by default)
• Keybindings to navigate between files with Cascade diffs (⌥/Alt + h and ⌥/Alt + l by default)

Misc

• Cascade panel open diff button now opens to the first change in the file
• Added option to control whether Cascade automatically opens created / edited files (enabled by default)
• Fixed minor autocomplete settings issues that affected some users
• New quick settings panel UI

Cascade Explain & Fix Problem

Explain & fix problem

• Cascade will attempt to fix issues in the codebase
• Option appears on hover of the issue

Import from Cursor

• Import settings and extensions
• Available via Command Palette or Reset Onboarding

New keybindings

• Keybinding for accept all active diffs in a file (⌘/Ctrl + ⏎ by default)
• Keybinding to reject all active diffs in a file (⌘/Ctrl + ⌫ by default)
• ⌘/ctrl + shift + L open new conversation in Cascade. It also copies selected terminal / editor text to new conversation

Improved Command

• Improved Command experience in Jupyter notebooks

Improved diff views

• Removes diffs in deleted files by Cascade
• Clearer cursor indication that text in a deleted text diff is selectable

Misc

• Windsurf quick settings dismisses when clicking outside the panel
• Increased visibility of elements on onboarding for certain themes
• Fixed minor layout issues
• Added button to join Discord community
• Increased stability of Cascade panel over SSH
• Files edited / created by Cascade will automatically open in the background. If there is no active editor, then the first edited / created file will open as current active editor
• Added a link to changelog in the title bar dropdown menu. Also added changelog nudge on title bar, which will show after user updated the version

Improvements & fixes

• Minor fixes to Cascade

Windsurf Launch

• Windsurf General Release!
• Chat with Cascade, Codeium’s full repo-aware chat with ability to make multi-file edits
• Blazing fast Autocomplete, with fast mode
• Supercomplete, a new modality that predicts next intent
• Command, with a brand new UX, with an ability to do larger file diffs and modifications