Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 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 and 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.exeprocesses - Proceed with installing the update and restarting Windsurf
Bug fixes and improvements
- Fixed bugs with some MCP servers
- Improved reliability of Devin Local agent
Devin for Terminal
Devin is now available for 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 for improving Windsurf 2.0 auth experience.
- Fixed bug with spawning Terminal sessions on Windows
Windsurf 2.0
Read the full announcement here.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.

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.Introducing Adaptive
We’ve made several model packaging changes, with more info here.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.
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.mdbeing ignored by Cascade in specific cases
MCP
- Add support for system-level Skill definitions 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_TRANSCRIPTcascade hook - Added Cascade hooks configuration visibility on team settings page
- Reduced the priority of Git commits in @ mention search
- Added a
windsurf.cascade.readClaudeCodeConfigflag 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/skillsdirectory - Tracking triggered rules in the
post_cascade_responsehook via a newrules_appliedfield - 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_codehooks 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
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
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
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: Typemegaplan 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
Enterprise Features
- Enterprise admins can now specify organization-wide allow and deny lists for command auto-execution. Learn more
Bug Fixes and Improvements
- Bug fixes and performance improvements for diff zones
- Improved overall stability and reliability
- Added
post_setup_worktreehook 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 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 pricingBug 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 WindsurfDownload the latest version on Windsurf 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
- 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.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.
Vibe and Replace
- Fixed reliability issues with Vibe and Replace.
Fast Context
- Added support for
.codeiumignoreand.gitignorefor 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.jsonis 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 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+Lwhen 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
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.
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.
Patch Fixes
- Fix using MCP tools with certain models.
- Fixes to terminal issues on Windows.
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 instead.
Patch Fixes
- Made improvements to the sign up onboarding flow.
- Various bug fixes and stability improvements.
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.
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
Patch Fixes
- Fixed API Pricing labels in the model selector
- Fixed bugs related to planning mode
- Fixed some behavior around conversation button dropdown
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 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
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
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
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
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

