;
};
The 3.1 series builds on the Devin Desktop rebrand with a smoother Agent/Editor experience, Devin Local improvements, and continued polish.
**Agent and Editor modes**
* Added the Agent/Editor switch to the collapsed-sidebar titlebar, and unified the search icon to open agent search.
* Kept the sidebar toggle in place when opening and closing the drawer.
* Smoothed switching between Agent and Editor modes so auxiliary windows no longer close and restore.
**Devin Local**
* Renamed the "Devin CLI" settings section to "Devin Local".
* Added a notification when Devin Local agent sign-in fails.
* Updated the bundled Devin Local agent to [v2026.5.26-8](/cli/changelog/stable#2026-5-26-8).
**Other improvements**
* Added `.devinignore` support alongside `.windsurfignore` and `.codeiumignore`.
* Settings and MCP marketplace pages now scroll across the full panel width and keep content centered on wide panels.
* Hardened migration from Windsurf on Windows to preserve shortcut icon.
* Improved handling of file context in Devin Local agent
* Increased proxy authentication timeout
* Fixed issues with some stdio MCP servers on Windows
### Enterprise
* Simplified model picker pricing view for select enterprise customers
Added a new command for Devin Desktop to rerun the migration from Windsurf. This will reset Devin Desktop settings and give you a second chance to import extensions and other settings from Windsurf. The "Reset migration from Windsurf" command can be found in the command palette.
If you are logged out of your account after migrating from Windsurf, we recommend opening the command palette via ctrl+shift+p (cmd+shift+p on macOS) and running the reset migration command.
Windsurf is now [Devin Desktop](https://devin.ai/blog/windsurf-is-now-devin-desktop).
# Bug fixes and improvements
## General
* Increased remote server startup timeout from 2.5s to 6s.
## Devin Local
This release updates the bundled Devin Local agent to 2026.5.26. See the [changelog](https://cli.devin.ai/docs/changelog/stable#2026-5-26-0) for the full list of changes.
* Devin Local is now aware of the files you have open in the editor as part of its context.
* When prompted for an MCP tool permission in Devin Local, two additional server-level options are now offered: approve all tools on the server for the current session, or permanently.
* Repaired hooks for Devin Local to allow blocking user prompts.
* Improved plan mode in Devin Local to work in the OS sandbox.
* "Always Allow" permission grants in Devin Local now persist across sessions.
* Image attachments in Devin Local now show the correct warning when the selected model does not support images.
# Bug Fixes and Improvements
* Fixed availability issues with swe-check model for some users.
* Improved terminal processing performance
* Restored conversation sharing
* Repaired path resolution for the Devin local agent on WSL
## Devin Review & Quick Review
All Windsurf IDE users now have access to [Devin Review](https://app.devin.ai/review) and [Quick Review](https://docs.windsurf.com/windsurf/quick-review) with your existing subscription.
* Devin Review is available for all self-serve users, with a 2 week free trial.
* Enterprise users can only use Devin Review with a Cognition platform agreement.
## Agent Command Center
* Added list display option for the agent inbox
* Improved sessions sidebar sorting and filtering
* Performance improvements for loading and switching sessions
## Windows updates
We have fixed a bug preventing updates for some users on Windows. To upgrade to this version, you may need to:
* Wait for the update to download.
* Once it is downloaded, open Windows Task Manager and close all `devin.exe` processes
* Proceed with installing the update and restarting Windsurf
## Bug fixes and improvements
* Fixed bugs with some MCP servers
* Improved reliability of Devin Local agent
# Bug Fixes & Improvements
## Bug Fixes
* Fixed a crash that could occur when switching between Cascade conversations
* Fixed an authentication issue that could prevent Devin Cloud sessions from starting
* Fixed an issue where responses to agent questions were not sent correctly
# Devin for Terminal
Devin is now available [for Terminal](https://devin.ai/terminal). All Windsurf users can use this new CLI agent with your existing subscription.
* **Runs on your machine** — Optimized for interactive work, with full access to your codebase, tools, and environment.
* **Hand off to the cloud** — Seamless hand off to Devin in the cloud, with its own VM, testing, video recordings, autofix and more. Come back to a finished PR.
* **Multi-model** — All of your favorite frontier models in one place, including Opus 4.7, GPT-5.5, and SWE-1.6.
* **Fast** — Written in Rust and so performant that the binary can run on an original VT100.
## Devin Agent in Windsurf
You can also enable the new Devin Local agent in Windsurf. This is the same agent harness used on the terminal and sessions can be accessed from both Windsurf and the CLI.
In our testing, it's up to 30% more token-efficient than the existing Cascade agent.
## Additional Changes
* Improved search subtitle layout during streaming
* Fixed file drag-and-drop in agent window Cascade tabs
* Fixed Go to Line/Column keybinding on Windows/Linux (Ctrl+Shift+G)
* Added support for server-driven extension deny lists
* Stability and performance improvements
# Bug Fixes and Improvements
* Fixed OAuth authentication issues for some MCP servers
# Bug Fixes and Improvements
* Fixed a regression with OAuth integration for some MCP servers
* Improved reliability of Devin Cloud connections in Windsurf
# Bug Fixes and Improvements
* Various bug fixes and performance improvements
# Bug Fixes and Improvements
* Various bug fixes and performance improvements for improving Windsurf 2.0 auth experience.
* Fixed bug with spawning Terminal sessions on Windows
# Windsurf 2.0
Read the full announcement [here](https://windsurf.com/blog/windsurf-2-0).
## Devin in Windsurf
* Devin cloud agent available directly inside Windsurf, included with every self-serve plan
* Delegate tasks from a local session to Devin with one click; Devin runs on its own VM
* Review Devin changes and test results without leaving the editor
* Billing is based on your existing quota and extra usage, with up to 50 USD in extra usage added for launching your first Devin Cloud session.
**Note:** Access to Devin Cloud is rolling out gradually. If you don't see it yet, try logging out of the website and IDE then logging back in.
Devin Cloud is disabled by default for enterprise accounts. Enterprise admins should enable Devin access in their organization settings if they have already purchased Cognition Platform.
## Agent Command Center
* New Kanban-style view showing all local and cloud agent sessions, organized by status
* Group agent sessions, PRs, files, and context into task-level Spaces
* Switch between Spaces to switch between tasks
## Additional Changes
* Refined Windsurf Browser with toolbar integration and Cascade tool for reading page contents
* Sped up initial load times for the Cascade sidebar
* Improved .gitignore and .codeiumignore handling across the product
* Stability improvements for remote extensions (WSL, SSH, Dev Containers)
* Performance improvements for typing in large active diff zones
## Adaptive Fix
We fixed a bug with the adaptive model router which prevented switching models after the first request.
All users who encountered the bug have had quota reset and overage restored.
## Adaptive Model Visibility
We've improved the visibility of the adaptive model in the model picker.
# Introducing Adaptive
We've made several model packaging changes, with more info [here](http://windsurf.com/blog/windsurf-adaptive).
## Adaptive Model Router
A new **Adaptive** model option is now available in the model picker. Adaptive intelligently selects the best model for each task, helping you make your quota last longer by avoiding overuse of premium models.
* **Availability**: Now available to all self-serve users on Pro, Max, and Teams plans.
* **Dynamic model selection** - Automatically chooses the right underlying model for your task while drawing down quota at a fixed per-token rate.
* **Extra usage promo** - Beyond your quota, extra usage is offered at 0.50 USD per 1M input tokens, 2.00 USD per 1M output tokens, and 0.10 USD per 1M cache read tokens for the next 2 weeks.
## Updated Model Picker with Pricing Context
The model picker now shows token pricing information directly, so you can see the exact rate extra usage is billed at.
* **Token pricing display** - Per-model input, output, and cache read token rates visible in the picker.
* **Prompt cache timer** - A new prompt cache timer is integrated into the context window indicator to help you track caching status.
* **Token counts in response cards** - Response cards after messages now include token counts so you can understand exactly how each message cost was calculated.
# Quota Billing
* Added support for the new quota billing system
* Daily and Weekly quota usage is now displayed directly in the IDE
# Bug Fixes and Improvements
* Fix build for Mac x64
# Bug Fixes and Improvements
* Various bug fixes and performance improvements
# Bug Fixes and Improvements
* Fix for Apple M5
## Cascade
* Fix dangling Diff Zones related to Jupyter Notebooks
* Improve Jupyter Notebook performance when running on WSL
* Improve Cascade UI rendering performance
* Fix Cascade agent panel crashes under certain conditions
* Improve notifications for model price changes
* Add support for loading SKILL.md files from the `.windsurf/skills/` directory
* Fix `AGENTS.md` being ignored by Cascade in specific cases
## MCP
* Add support for [system-level Skill definitions](https://docs.windsurf.com/windsurf/cascade/skills#system-level-skills-enterprise) via MDM-managed configs for Enterprise
* Improve context management for MCP servers
## Stability & Performance
* Improve autocomplete error handling and performance
* Improve SSH & Remote performance
# Bug Fixes and Improvements
* Fix extension installation version selection
## New Model Picker
We introduced a new model picker that groups models by family and adds a hovercard with toggles for
specific variants, like reasoning effort and speed.
Separately, we also added the ability to pin models.
## Cascade Improvements
* Added `POST_CASCADE_RESPONSE_WITH_TRANSCRIPT` cascade hook
* Added Cascade hooks configuration visibility on team settings page
* Reduced the priority of Git commits in @ mention search
* Added a `windsurf.cascade.readClaudeCodeConfig` flag to disable reading Claude configuration
## MCP Improvements
* Added an MCP Refresh button
* Auto-trigger OAuth login when adding HTTP/SSE MCP servers
* Fix bugs with parsing on Windows and startup
## Platform Improvements
* Merged changes from VS Code 1.108
* Improved startup reliability for Cascade
* Fixed Windows update initialization path that could block updates
* Released binaries for Linux ARM64
# Bug Fixes and Improvements
* Fix compatibility with GitHub Pull Requests extension
# Bug Fixes and Improvements
* Fix for self-updating on Windows
* Fix for macOS UI flickering
# Cascade Improvements
* Plan Mode now supports automatic switching back to Code Mode when you start implementing a plan
* Added support for reading skills from the `.agents/skills` directory
* Tracking triggered rules in the `post_cascade_response` hook via a new `rules_applied` field
* Diff zones will now automatically close on commit
# Linux ARM64 Support
* Full Linux ARM64 client support with deb and rpm packaging
# Enterprise & Team Improvements
* Cloud configuration for Cascade Hooks is now available for enterprise teams via the cloud dashboard
* Support for Devin service key authentication
# Bug Fixes and Improvements
* Fixes for `post_write_code` hooks to handle all code editing tool formats
* Fixes and improvements for MCP server resource loading
* Fixed osascript privilege escalation being incorrectly triggered on Linux for shell command installation
* Addressed multiple memory leaks
* Improved RTL language rendering in todo lists
# New Models
* GPT-5.3-Codex-Spark is now available in Arena Mode's Fast Arena and Hybrid Arena battle groups
# Claude Opus 4.6 (fast mode)
Claude Opus 4.6 (fast mode) is now available in Windsurf in research preview with limited-time promotional pricing for self-serve users until Feb 16:
* **No thinking:** 10x credits
* **With thinking:** 12x credits
Opus 4.6 (fast mode) has the same intelligence as Opus 4.6 but with up to 2.5x higher output speeds.
# Claude Opus 4.6
Claude Opus 4.6 is now available in Windsurf with limited-time promotional pricing for self-serve users:
* **No thinking:** 2x credits
* **With thinking:** 3x credits
Opus 4.6 is available in Arena Mode's Frontier Arena and Hybrid Arena. Try it head-to-head against other frontier models to see how it performs on your real-world tasks.
* Various bug fixes and performance improvements
* Released Tab v2 model selector to all users
# Bug Fixes and Improvements
* Fix issues with Arena Mode Battle Groups
# Bug Fixes and Improvements
* Improve UI styling for announcement popups and notifications
* Close model picker when selecting a battle group
# Wave 14: Arena Mode
Arena Mode brings side-by-side model comparison directly into your IDE, plus Plan Mode for smarter task planning.
## Arena Mode
Run two Cascade agents side-by-side with hidden model identities and vote on which performs better. Arena Mode lets you discover which models actually work best for *your* workflow, codebase, and tasks—not just what benchmarks or influencers say.
* **Battle Groups**: Choose specific models to compare or let Windsurf randomly select from curated groups like "fast models" vs "smart models"
* **Personal & Global Leaderboards**: Your votes contribute to both a personal leaderboard (your preferences) and a global one (across all Windsurf users)
* **Sync or Branch**: Send followup prompts to both agents simultaneously, or branch and explore different paths individually
To get started, select the new **Arena** tab in the model picker. All battle groups are free for the first week for paid users.
## Plan Mode
Plan Mode is a new Cascade mode alongside Code and Ask. Use it to create detailed implementation plans before diving into code.
**Pro tip**: Type `megaplan` in the Cascade input box to trigger an advanced form that asks clarifying questions to create a more aligned, comprehensive plan.
# Bug Fixes and Improvements
* Admins can now set a default model that applies to all team members when they first open Windsurf
* Various bug fixes and performance improvements
# Bug Fixes and Improvements
* Fix bug with permanently disconnected cascades
# Bug Fixes
* Fixes commit message generation and codemaps suggestions
# Enterprise Features
* Enterprise admins can now specify organization-wide allow and deny lists for command auto-execution. [Learn more](https://docs.windsurf.com/windsurf/terminal#team-wide-command-lists-teams-&-enterprise)
# Bug Fixes and Improvements
* Bug fixes and performance improvements for diff zones
* Improved overall stability and reliability
* Added [`post_setup_worktree`](https://docs.windsurf.com/windsurf/cascade/worktrees#setup-hook) hook for initializing worktrees in Cascade
# Bug Fixes and Improvements
* Improvements to GPT-5.2-Codex harness
* Admins can now manage Windsurf restrictions via Windows Group Policy
# GPT-5.2-Codex
Adds support for GPT-5.2-Codex with four reasoning efforts (low, medium, high, and xhigh).
GPT-5.2-Codex is OpenAI's latest model designed for agentic coding. It excels at working in large codebases over long sessions.
For most tasks, we recommend using the medium reasoning effort.
# Bug Fixes and Improvements
* Various bug fixes and performance improvements
* Improved stability and reliability
# New Features and Improvements
* Windsurf now supports [Agent Skills](https://docs.windsurf.com/windsurf/cascade/skills) for Cascade.
# Bug Fixes and Improvements
* Various bug fixes and performance improvements
* Improved stability and reliability
# Gemini 3 Flash
Gemini 3 Flash is now available for all users. This model combines Gemini 3 Pro-grade reasoning with Flash-level speed and efficiency, making it ideal for agentic workflows and coding tasks.
* **Blazing Fast Responses**: Experience near-instant feedback with 3x faster performance than previous generations, perfect for iterative development compared to Gemini 3 Pro
* **Superior Coding Intelligence**: Outperforms even Pro-tier models on key coding benchmarks (78% on SWE-bench Verified), providing more accurate code generation and debugging
* **Deep Multimodal Understanding**: Easily process complex video, data extraction, and visual Q\&A tasks with frontier-level reasoning
# Bug Fixes and Improvements
* Various bug fixes and performance improvements
* Tab fixes and improvements
# Wave 13: Merry Shipmas
Wave 13 brings first-class support for parallel, multi-agent sessions in Windsurf, along with Git worktrees, side-by-side Cascade panes, and a dedicated terminal profile for more reliable agent execution.
## SWE-1.5 Free
Our near-frontier model, SWE-1.5, is now available for free to all users for the next 3 months. SWE-1.5 Free has the full intelligence of SWE-1.5, with the same coding performance on SWE-Bench-Pro, but delivered at standard throughput speeds. The original variant of SWE-1.5 hosted on Cerebras will continue to be available for paid users. SWE-1.5 Free will replace SWE-1 as the default model in Windsurf starting today.
## Git Worktree Support
Windsurf now supports Git worktrees, letting you spawn multiple Cascade sessions in the same repository without conflicts. Git worktrees check out different branches into separate directories while sharing the same Git history.
## Multi-Cascade Panes & Tabs
You can already run multiple Cascade sessions in Windsurf at the same time. Now, you can view and interact with them in separate panes and tabs within the same window. This lets you monitor progress and compare outputs of sessions side-by-side, or even turn Windsurf into a big Cascade dashboard.
## Cascade Dedicated Terminal (Beta)
Windsurf introduces a new approach for letting agents execute terminal commands. Instead of your default shell, Cascade will now run commands in a dedicated zsh shell specifically configured for reliability. The Cascade Dedicated Terminal can use the environment variables you set in your .zshrc configuration and is interactive, which means you can answer any prompts from shell scripts without having to break your flow. This should improve the reliability and speed of shell commands, especially for users with complicated prompts (e.g., powerlevel10k).
In this version, the Cascade Dedicated Terminal will be opt-in for Windsurf Stable on macOS. If you are experiencing issues with the older legacy terminal, we recommend switching to the new terminal early. We expect to make this feature the default in the future, while maintaining the legacy terminal extension for backwards compatibility purposes. You can opt-in in the Windsurf User Settings -> Disable Windsurf Legacy Terminal Profile.
## Context Window Indicator
When a model's context window grows too long, earlier context can be dropped without warning and performance can degrade. Cascade already extends the window by occasionally summarizing messages and clearing history. This release adds a visual indicator to see how much of your context window is currently in use, helping you anticipate limits and decide when to start a new session.
## Cascade Hooks
Execute custom commands at key points during Cascade's workflow, including on model response for auditing purposes.
## System-level Rules & Workflows
Enterprises can deploy rules and workflows via MDM policies, allowing organizations to place rules and workflows files on users' machines.
# Bug Fixes and Improvements
* Enhanced diff zone behavior with configurable scroll-to-next-hunk settings (default off)
* Preserved colors and styling in Cascade terminal output
* Multiple fixes to the Model Context Protocol implementation
* Supports lowering permissions for Cascade's Web Fetch tool
* Fix race condition in the dedicated terminal implementation
* Support force killing commands in the dedicated terminal
* Improved markdown completion
* Fix opening old Cascade diffs
# Features
Added a new "Promo" label to LLM models that are newly available or have special discount pricing
# Bug fixes and improvements
## Agents & Tool Execution
* Fixed Command-I functionality
* Fixed Ctrl+C during tool execution not working properly
* Fixed Go (fallback) processes not being killed properly
* Fixed handling of parallel tool call errors
* Improved MCP tool call visibility (show tool name, args, etc)
* Fixed fallback diff handling for nonexistent files in code actions
## UI & Rendering
* Fixed incorrect indentation from code blocks in terminal rendering
* Fixed nested lists not rendering on new line in terminal markdown
* Fixed content spacing issues
* Fixed streaming flashes
* Enhanced code block file path display to hide line numbers for whole files
* Improved citation and language parsing in code blocks with a more robust regex pattern
* Updated the UI for code block title bars to properly handle long paths with truncation
* Improved the auto-run command menu interface and its display logic
* Added loading indicators when thinking or during long running operations
* Fix opening old Cascade diffs
## Platform & Messaging
* Fixed rate limit error message to say "no credits were used" instead of "credits have been refunded"
* Fixed continuously rechecking for updates on macOS
* Added a user-facing message when API providers are exhausted
## Workspace & Onboarding
* Allowed clicking items in the Windsurf onboarding pane
* Respect gitignore patterns in the workspace directory tree
# Patch Fixes and Improvements
* Reduce occurrence of "prompt is too long" errors
* Request all supported scopes if no scopes are provided in MCP OAuth config
# GPT-5.2
GPT-5.2 is now available in Windsurf. This model will be available for 0x credits in Windsurf (to paid users) for a limited time.
GPT-5.2 represents the biggest leap for GPT models in agentic coding since GPT-5 and is a SOTA coding model in its price range. The version bump undersells the jump in intelligence. We\`re excited to make it the default across Windsurf and several core Devin workloads. - Jeff Wang, CEO of Windsurf
Download the [latest version on Windsurf](https://windsurf.com/download/editor) to try it out!
# Bug fixes and improvements
* General Windsurf stability and performance improvements
* General Tab (Supercomplete) improvements and stability
* Fixes issues with Cascade running commands that could not be cancelled during certain long-running processes
# Features & Tools
## Cascade Hooks on User Prompts
Users can now configure Cascade Hooks on user prompts for logging all user prompts and blocking policy-violating prompts.
## MCP Servers
* Added support for GitLab remote MCP.
* Added OAuth support for GitHub remote MCP.
* Fixed an issue where every MCP would reauth on opening Windsurf.
* Added support for [MCP prompts](https://modelcontextprotocol.io/docs/concepts/prompts)
* Added toggles to enable/disable MCPs in the Cascade header
# Diff Zones
* Fixes issues with diff zones not rendering correctly or jumping to the end of a file when editing
# Tab (Supercomplete)
* Improves reliability of Tab autocomplete
* Makes Tab more responsive and faster in the appropiate circumstances
# Bug fixes and improvements
* General stability and performance improvements
* Fixes issues with login timing out too quickly during onboarding
# GPT-5.1-Codex Max
Introducing GPT-5.1-Codex Max in three reasoning tiers (Low, Medium, High). Low variant available at no cost to paid users for a limited time.
# Patch Fixes and Improvements
* General bug fixes and improvements.
# Claude Opus 4.5
You can now use Claude Opus 4.5 in Windsurf!
Opus 4.5 is the most capable model in Windsurf yet and is now available at Sonnet pricing for a limited time (2x credits compared to 20x for Opus 4.1).
This model is available to all paid Windsurf subscribers.
# AI Models
## Gemini 3 Pro
* Resolved an issue where Gemini 3 Pro caused internal Cascade errors for some users.
## SWE-1.5
* Fixed notebook tool functionality for SWE-1.5.
* Addressed an issue where SWE-1.5 would unexpectedly stop or return "No response requested".
## Sonnet 4.5
* Added support for Sonnet 4.5 with a 1M token context window.
* Reduced the frequency of unnecessary Markdown file creation by Sonnet 4.5.
## GPT-5.1 Codex and Codex Mini
* Added support for GPT-5.1 Codex and Codex Mini with low reasoning effort configuration.
# Features & Tools
## Codemaps
* Improved reliability of saving and retrieving Codemaps.
* Fixed Codemap sorting and increased the limit of visible open Codemaps.
* Resolved issues with mentioning Codemaps in Cascade.
## MCP Servers
* Fixed scope handling and OAuth authentication flows for various MCP servers.
* Resolved issues preventing installation of new MCP servers.
* Added support for handling embedded resource content in tool call responses.
## Tab Completion
* Improved latency, responsiveness, and accuracy of autocomplete.
Note: The Autocomplete setting has been removed as it was a legacy option that had no effect. Windsurf's Tab autocomplete feature is powered by Supercomplete.
## Vibe and Replace
* Fixed reliability issues with Vibe and Replace.
## Fast Context
* Added support for `.codeiumignore` and `.gitignore` for Fast Context.
# General Improvements
* Fixed various UI alignment issues with icons and styles.
* General performance and stability improvements.
* Fixed issues with the file search tool.
# Gemini 3 Pro Preview
* You can now use Gemini 3 Pro (Low and High) in Windsurf! This is a preview release that is available to paid Trial, Pro, and Teams subscribers and will soon be extended to Enterprise users as well.
# GPT-5.1 Priority Mode
* Added priority processing support for GPT-5.1 models, providing guaranteed low-latency responses for faster (\~50 tokens/sec), more reliable AI assistance.
* Priority processing costs 2x the standard rate, which will be reflected in the Windsurf credit system.
# Patch Fixes and Improvements
* Fixed tool call calling issues for GPT-5.1-Codex and GPT-5.1-Codex Mini models
# GPT-5.1 and GPT-5.1-Codex
GPT-5.1 and GPT-5.1-Codex are now available in Windsurf. GPT-5.1 will become the default model in Windsurf for one week, and paid users get free access during this period.
GPT-5.1 and GPT-5.1-Codex deliver a solid upgrade from GPT-5 for agentic coding workflows. They're noticeably better at understanding what you're asking for and working with you to get it done. The new variable thinking feature dynamically adjusts reasoning depth—providing quick responses for simple tasks and more thoughtful analysis when complexity demands it.
# Patch Fixes and Improvements
## MCP Improvements
* **Loading state indicators**: Show loading state per installed MCP to improve visibility during initialization.
* **Refresh only edited MCPs**: When `mcp_config.json` is modified, only the affected MCP server instance is initialized/refreshed; no other instances are refreshed.
* **Increased initialization timeout**: MCP initialization timeout increased to 60s.
* **Refresh button for error states**: Show refresh button for MCPs in error state to allow manual recovery.
## Cascade Hooks
* **Cascade Hooks feature**: New Cascade Hooks feature available to all tiers.
* **Documentation**: See [Cascade Hooks docs](https://docs.windsurf.com/windsurf/cascade/hooks) for available hooks and usage examples.
## SWE 1.5 Image Support
* **Image understanding**: SWE 1.5 now supports image understanding, enabling visual content analysis.
## Removed Features
* **Knowledge Base**: Removed the Knowledge Base feature.
## Bug Fixes
* **Vim extension typing lag**: Fixed bug causing typing lag when Vim extension is enabled.
* **PowerShell + Turbo Mode**: Fixed an issue where PowerShell was not running commands when Turbo Mode is enabled.
## Shortcuts
* **Attach current file to Cascade**: New shortcut `Option/Alt+Cmd+L` when in an editor to attach the current file to Cascade.
# Features
## Expanded Codemaps
Codemaps now include powerful new capabilities:
* **Chat with map** - Interact directly with your codebase visualizations
* **Mermaid diagrams** - Generate visual diagrams within maps for better code understanding
* **Cascade suggestions** - Get AI-powered suggestions directly in your maps
* **Map option in chat/edit nudges** - Easily create maps from chat and edit interactions
* **Smart mode option** - Enhanced intelligent assistance when working with maps
## Cascade Summarization Fix
Improved Cascade summarization to better handle longer conversations. Previously, summaries could be too aggressive and drop important context. Now maintains better continuity across long sessions with multiple file changes and user messages.
## MCP Enhancements
* **Path component handling** - Improved support for MCP URLs with path components (e.g., Smithery MCPs)
* **OAuth flow improvements** - Better OAuth flow for streamable HTTP MCPs
# Bug fixes and improvements
## Performance Improvements
* **Sticky scroll lag fixes** - Resolved lag spikes when using sticky scroll with Vim bindings
* **General slowness fixes** - Addressed performance issues caused by VSCode OSS update
* **Terminal rendering optimization** - Fixed rendering loop that caused 500ms+ delays on first terminal open
## Terminal Fixes
* **PowerShell improvements** - Fixed Windows terminal integration edge cases where commands would appear stuck
* **Shell theme compatibility** - Resolved edge cases with custom shell themes (zsh, fish, powerlevel10k, etc.) that could cause Windsurf to break or show stuck commands
## Editor Stability
* **Terminal freeze fix** - Fixed an issue where the editor would freeze when opening the terminal
* **CMD+J fix** - Resolved layout thrashing issue when opening terminal pane with CMD+J
# Falcon Alpha
You can now try a new stealth model in Windsurf: Falcon Alpha. Falcon Alpha is a powerful agentic model designed for speed. We're excited to hear what you build with it!
# Patch Fixes and Improvements
* Various performance improvements and bug fixes.
# Patch Fixes and Improvements
* Support and fixes for AGENTS.md
* Improvements and bug fixes for Codemaps.
* Improvements to Fast Context. Enterprises can opt in using the Windsurf Team Settings. Users can toggle Fast Context automatically using "CMD/Ctrl + Enter" on the first message in a chat.
* New auto-linting behavior that speeds up Cascade.
* Fix for MCP Marketplace not respecting team whitelist options.
* Fixes for Jupyter Notebook tool.
* Fixes for Memories, Rules, and Workflows.
* General bug fixes and improvements.
* Performance optimizations and stability enhancements.
# Dependencies
* Updated Code OSS to version 1.105.0 (Electron: 37.6.0, Chromium: 138.0.7204.251)
# Patch Fixes
* Resolved issues affecting SSH remote connections with high resource usage.
* Fix certain models seeing increased error rates on editing files.
* Improved diagnostics for third party extensions.
# New Features
* **Fast Context**: Introduced Fast Context subagent powered by SWE-grep, enabling agents to find relevant code context up to 20x faster with >2,800 tokens per second throughput.
Learn more on our [blog](https://cognition.ai/blog/swe-grep).
# Bug Fixes
* Fixed issues with WSL compatibility.
* Fixed bugs in Workflows and Rules UI.
* Various stability improvements and minor bug fixes.
# Patch Fixes
* Fixes issue with custom MCP servers not being displayed correctly in the new MCP panel.
* Improvements and bug fixes for the beta Codemaps feature.
* Fixes issue where some bash commands would get stuck.
* Fixes issue where certain models couldn't create or edit Jupyter notebooks.
* General bug fixes and improvements.
# Codemaps
* Codemaps is a beta feature for codebase understanding and navigation. Open the codemaps pane to try it out!
# Patch Fixes
* Fixes to Cascade to reduce internal errors.
* Fixes to Cascade not seeing terminal output.
* Various other bug fixes and stability improvements.
# Claude Sonnet 4.5
* Claude Sonnet 4.5 is now available
# Patch Fixes
* Fix using MCP tools with certain models.
* Fixes to terminal issues on Windows.
# Patch Fixes
* Fix to Cascade slowness issues
# GPT-5-Codex is now in Windsurf!
GPT-5-Codex is now available for free (0x credits) for a limited time for paid users!
Free users can use GPT-5-Codex as well for 0.5x credits.
# Cascade Improvements
## Queued messages
* Users can now add follow-up messages to Cascade while it is working, and Cascade will process them in order after the current task is complete.
## Mermaid diagram support
* Cascade now renders mermaid diagrams in the conversation.
# Deprecation
* Windsurf Browser is now deprecated. We plan to refactor and release a replacement feature in the coming months. Please use [Previews](https://docs.windsurf.com/windsurf/previews) instead.
# Patch Fixes
* Made improvements to the sign up onboarding flow.
* Various bug fixes and stability improvements.
# Patch Fixes
* Minor improvements and bug fixes
# Patch Fixes
* Minor improvements and bug fixes
# Patch Fixes
* Minor improvements and bug fixes
* Memory improvements
# Patch Fixes
* Minor improvements and bug fixes
# Devin features in Windsurf, stability improvements, and a brand new UI
* **Stability & Performance**: Over 100 bug fixes and reliability improvements.
* **DeepWiki in Windsurf**: Hover over code symbols for intelligent DeepWiki-powered documentation.
* **Vibe and Replace**: AI-powered find and replace functionality. Apply intelligent transformations to multiple code matches.
* **Cascade Agent Improvements**: Automatic planning mode with no manual toggles required. Revamped tools with more accurate edits. Enhanced code exploration leveraging long context models.
* **Tab Autocomplete**: New system with more frequent and smarter suggestions.
* **UI Redesign**: All-new Chat, Cascade, and home screen panels.
* **Dev Containers**: Support for development containers via remote SSH access.
# GPT-5 Available
Windsurf now supports the GPT-5 suite of models including GPT-5 (low reasoning), GPT-5 (medium reasoning), and GPT-5 (high reasoning). They are available for free for a limited time for paying users!
# Patch Fixes
* Minor improvements and bug fixes
# Patch Fixes
* Minor improvements and bug fixes
# Patch Fixes
* Minor improvements and bug fixes
# Kimi K2 Available
Windsurf now supports Kimi K2 model which costs 0.5 credits per prompt.
# Speak to Cascade
## Voice
* Users can now speak into the chat rather than having to type things out.
## @-mentioning conversations
* @-mention the first conversation so Cascade has full context of it as it goes to write tests for you.
## Deeper Browser integration
* Chat with Cascade about tabs that are open in the Browser using @-mentions
## JetBrains improvements
* Planning Mode, Workflows, and file-based Rules are now available for Cascade on JetBrains
## Improvements
* Now you can @-mention terminal in Cascade.
* You can turn on the Auto-Continue setting to have Cascade automatically continue its response if it hits a limit.
* Support for more MCP servers with easier and more secure authentication by integrating the new Streamable HTTP transport (replaces SSE) and MCP authentication (replaces access tokens or API keys in the config).
* Important for enterprise customers who use Windsurf across lots of repos. Now, you can enforce ignore rules across all repositories by placing .codeiumignore in the \~/.codeium/ folder
# Linux Fixes
* Fixes to RHEL 8 Support
# Cascade Improvements
* Improvements to Cascade reliability
# Patch Fixes
* Minor improvements and bug fixes
# Browser Fixes
* Fixed unauthenticated missing CSRF token
# Patch Fixes
* Fixed API Pricing labels in the model selector
* Fixed bugs related to planning mode
* Fixed some behavior around conversation button dropdown
# Windsurf Browser
* Ability to share browser context with Windsurf
* Share code blocks, selected text, web page elements, screenshots, and console logs
* Send blocks directly to Cascade
## Fixes
* Fixed writing to plan.md files for Enterprise users
# Planning Mode
* Send messages to Cascade in Planning Mode, a setting that will let Cascade plan before making edits
* Cascade will create a plan.md file of the actions it plans to take before taking action
* The plan is user-editable, and Cascade will pick up on user changes
## Terminal Improvements
* Native terminal in Cascade panel
* Terminal now accepts user inputs in the Cascade panel
## Legacy Mode Removal
* Legacy mode has been removed, leaving Write and Chat mode
## Improvements
* Icons in @-mentions
* Theme-aware codeblocks with refreshed design
* Improvements to `.codeiumignore`
* New menu to open previous conversations to quickly switch conversations
# Patch Fixes
* Fixed Cascade and terminal integration issues for Mac and Linux users
* Merged upstream changes from VS Code 1.99.3
* Improvements to import behavior during onboarding
* Fixed shadow with the App Icon on Mac
# Bring your Own Anthropic Key
## BYOK (Anthropic Key)
* You can now bring your own API Key from Anthropic to use the Claude 4 Sonnet, Claude 4 Sonnet (Thinking), Claude 4 Opus, and Claude 4 Opus (Thinking) models in Cascade
* To use BYOK, go to [provide API keys](https://windsurf.com/subscription/provider-api-keys) and input your key
* Once entered, go back to Windsurf and reload the window. You should now be able to use the new models
* This is only available for Free and Pro users at this time
# SWE-1 Improvements
* Adds multi-modal (image) support to SWE-1
# New Family of SWE-1 Models
## SWE-1
* New SWE-1 Model made by Windsurf is available in Cascade
* SWE-1 is a new model with frontier model-level capabilities
* Free for a limited time for Pro Users
## SWE-1-lite
* SWE-1-lite is a new, far more capable model replacing Cascade Base
* Free to use for all plans and tiers
## SWE-1-mini
* SWE-1-Mini is our revamped model for tab completion in Windsurf
## Misc
* Few memory leak bug fixes
* Various fixes to Cascade Plugin Panel
# Cascade Customization
## Cascade UX Improvements
* Redesigned Model Selector
* Continue button when reaching individual tool call limit
* Opening conversations will now open the associated workspace
* Hunk accept/reject widget now has a compact mode to cover less code
* Improvements to commit message generation quality
* Commit message generation reads from global rules as context
* Ability to edit proposed terminal command
## Custom Workflows
* You can create “workflows”, saved prompts that Cascade can follow
* Workflows can be invoked via slash command
* Cascade can help create and edit workflows
* Workflow files are saved in the workspace, under .windsurf/workflows
## File-Based Rules
* You can create granular rules files that are always on, @mention-able, requested by Cascade, or attached to file globs
* Rules files are saved in the workspace, under .windsurf/rules
## Simultaneous Cascades
* Allow Cascade to keep running when switching to another conversation
* Add support for switching between conversations via a dropdown menu or keyboard shortcuts
## Cascade Plugins
* New panel in Cascade for managing MCP Servers
* Easier one-click uninstall and install
* Easier search
* MCP now has MCP resources and multimodel responses
* More MCP Server options coming soon
## Fixes
* Fixed tool call errors for users with disabled telemetry
* Fixed crashes around workspace conversation
# Teams Features
## Teams: Windsurf Reviews
* Team admins can install a Github app for code review and PR title/description edits
* Available to Teams and Enterprise SAAS for 500 reviews/month
## Teams: Conversation Sharing
* Team users can generate a shareable URL to a Cascade conversation
* Only fellow team members can access this URL
* Available to Teams and Enterprise SaaS
## Teams: Knowledge
* Team admins can connect their Google account and curate relevant Google Docs
* Team members will be able to @mention these docs, and Cascade can retrieve them
* Available to Teams and Enterprise SaaS
## Teams Deploys
* Teams users can connect their Netlify account via Windsurf settings
* Deploy apps through Cascade directly to your Netlify team for full control
* Supports team-specific settings like SSO, custom domains, and more through the Netlify dashboard
* Team admins can manage Deploy permissions and settings for their team.
## Teams Analytics
* Teams users get a refreshed analytics dashboard for their team
* Includes new Cascade analytics such as messages sent, total tool calls, model usage, and more
## Misc
* Upgrade to VS Code 1.99.1
# Patch Fixes
* Reduced errors for edit tool calls for Windows
* Fixed model selection and loading bugs on Command
# New App Icon & Upgraded Free Tier
## New App Icon
* Windsurf is now refreshed with a new app icon
* Windsurf.com has been updated with the new wordmark
* (Mac) Customizable app icons now use the new logo
## Upgraded Free Tier
* Free tier now has new, higher limits
* Ability to use Cascade in write mode
* Cascade prompt credits: 5 to 25 Cascade prompt credits per month
* Unlimited Fast Tab
* Unlimited Cascade Base
* Access to Previews
* 1 Deploy
## Performance Improvements
* Performance and reliability improvements when deploying an app using Deploys
* Allow users to create a new deployment even if they have an existing deployment config yaml
* Deploy web app tool now has a check deploy status tool call
* Stability improvements for remote extensions (WSL, SSH, Dev Containers)
* Performance improvements when typing in a large active diff zone
## Misc
* Adds GPT-4.1 to Command
* Upgraded to VSCode base version 1.98
# Patch Fixes
* Updates IDE marketplace link by mirroring Open VSX
# Updated & Simplified Pricing
## We're getting rid of Flow Action Credits
* We're simplifying our pricing model by removing Flow Action Credits
* Change takes effect April 21st, 2025
* Plans now come with prompt credits with add-on credits available for purchase
## User Prompt Credits
* Plans now come with prompt credits, which are consumed per every message sent and not via every tool call
* Add-on credits are available for purchase
* Auto-top off (with max limits) can be enabled via profile
## Existing Plans
* Existing plans are migrating over to the new pricing model
* For more information, please visit the Pricing page
# o4-mini Available
## New o4-mini models available and Free (Limited Time)
* Windsurf now supports the o4-mini medium and o4-mini high models, which are free for all users
* Usage in Windsurf is free for a limited time from April 16th to April 21st
# GPT 4.1 Available
## New GPT 4.1 Model available and Free (Limited Time)
* Windsurf now supports the new GPT 4.1 model, which is free for all users
* Usage in Windsurf is free for a limited time from April 14th to April 21st
# Patch Fixes
* Fixes to Commit Generation parsing on Windows
* UI Fixes to Rules
* Allow empty files on website deploy
* Better Deploys error visibility
* Ability to edit subdomain on website deploy
* Increased stability around MCP SSE connections
* Cascade bug fixes
# Patch Fixes
* Fixes to "Remote - WSL" extension
* Minor UX fixes
# Deploys
## Deploys (Beta)
* Deploy your application with one prompt to Netlify under a windsurf.build domain
* Claim your application's URL via Netlify
* Once claimed, continue deploying to the same project as you make updates
* To deploy a new site or change your subdomain, just ask Cascade to deploy to a new subdomain
* Available to all users for all tiers, with more for paid plans
## Commit Message Generation (Beta)
* Generate commit messages with a click in the Source Control Panel
* Available to users on paid plans with no additional credit cost per use
## Improvements to Memories
* New memories tab in Cascade
* New ability to edit Cascade's generated memories, including the memory's title, content and tags
* New ability to search Cascade's generated memories
* User setting toggle for Auto-Generate Memories
* When enabled, Cascade will autonomously generate memories to remember important context
* When disabled, Cascade will only create memories when you explicitly ask in your prompt
## Improvements to Long Conversations
* Introduced Cascade table of contents of all past user messages, which appears on conversation scroll
* Table of contents enables the ability to revert or scroll to any past message
* Improved performance when interacting with long conversations
## Improvements to Windsurf Tab
* Jupyter Notebook Support for Windsurf Tab
* Additional context signals for Windsurf Tab, including in-IDE search
# New Mac Icons
* Two new application icons (Retro and Pixel Surf) are available for users on paid plans
# Misc
* Cascade new conversation screen now has a new toolbar for tools like MCP, Preview and Deployments.
* Cascade now supports SSE MCP servers in the JSON configuration
* Fixed "Open Cascade on Reload" setting so Cascade will be closed upon opening a new window when setting is disabled
* Cascade input is persisted across new conversation screen and an active conversation
* Refreshed terminal UI in Cascade, with increased visibility for the "Open terminal" button, which opens Cascade's terminal instance directly
* Underlined links are now clickable in Cascade and user messages
* New user setting to enable sound when Cascade is done running (beta)
* Fixes to "Remote - SSH" extension, including custom SSH binary path setting
* Merged changes from VS Code 1.97.0
