> ## 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. # Devin Desktop changelog > Release notes for every Devin Desktop (Windsurf) stable release: new features, improvements, and fixes in each version of the agent-native editor. export const Release = props => { const AppleIcon = iconProps => ; const WindowsIcon = iconProps => ; const LinuxIcon = iconProps => ; const DownloadIcon = iconProps => ; const RELEASE_SECTIONS = [{ name: "macOS", Icon: AppleIcon, items: [{ prop: "darwinArm64", label: "macOS for Apple Silicon (Archive, .zip)" }, { prop: "darwinArm64Dmg", label: "macOS for Apple Silicon (.dmg)" }, { prop: "darwinX64", label: "macOS for Intel (Archive, .zip)" }, { prop: "darwinX64Dmg", label: "macOS for Intel (.dmg)" }] }, { name: "Windows", Icon: WindowsIcon, items: [{ prop: "win32Arm64User", label: "Windows arm64 (.exe)" }, { prop: "win32Arm64Archive", label: "Windows arm64 (Archive, .zip)" }, { prop: "win32X64User", label: "Windows x64 (.exe)" }, { prop: "win32X64Archive", label: "Windows x64 (Archive, .zip)" }, { prop: "win32Arm64", label: "Windows arm64 System Installer (.exe)" }, { prop: "win32X64", label: "Windows x64 System Installer (.exe)" }] }, { name: "Linux", Icon: LinuxIcon, items: [{ prop: "linuxX64", label: "Linux x64 (.tar.gz)" }, { prop: "linuxX64Deb", label: "Linux x64 for Debian (.deb)" }] }]; const sections = RELEASE_SECTIONS.map(section => ({ ...section, items: section.items.filter(item => props[item.prop]) })).filter(section => section.items.length > 0); if (sections.length === 0) { return null; } return

{sections.map(section => { const Icon = section.Icon; return

{section.name}

{section.items.map(item => {item.label} )}

; })}

; }; **Devin Desktop** * Added support for connecting to MCP servers on protocol revision 2026-07-28 (`server/discover`, no `initialize`). * Enterprise admins can now set an **Extension marketplace URL** in the Devin Desktop team settings. When set, Devin Desktop searches for and installs extensions from that marketplace only. See [Admin controls](/desktop/controls). * Improved performance for very large or deeply nested folders. * Replaced folder and git-@ mention system with a faster integration while removing the code context @-mention category. * The model picker remembers the variant you last used for each model family, instead of resetting to the family default. * **\[Private Preview]** Devin Desktop can now connect to remote MCPs configured in Devin Cloud. Only enterprise-level MCPs will be reached.

**Sign in with ChatGPT** You can now [sign in to Devin with ChatGPT](https://devin.ai/blog/sign-in-with-chatgpt) and use your eligible ChatGPT Plus or Pro plan for GPT model usage in Devin Desktop. Choose a GPT model and those requests are billed to your ChatGPT plan; for the best value, use Fusion with GPT-6 Astra as the lead and SWE-2 as the sidekick. See [Use your ChatGPT plan](/admin/billing/chatgpt) for setup and eligible models. **Devin Desktop** * New commands **Devin: Save Language Server Memory Profile** and **Devin: Save Language Server CPU Profile** save a diagnostic `.zip` you can send to support. * Long or noisy shell commands no longer grow the Agent window's memory with every terminal refresh, which could crash the window. * New Agent sessions started without a folder pick keep every folder of a converted multi-folder workspace, instead of only the first one. * Devin Desktop keeps a much smaller local settings file for accounts with many available models, and resolves user settings once per change instead of on every read. Typing, selecting text, and copy/paste no longer stall the extension host. * Session list polling backs off while Devin Desktop is unfocused or the conversation dropdown is closed. **Devin Desktop** * Devin Desktop no longer crashes at startup on Apple Macs using M6 chips * Fixed a memory leak with the agent command center * Choosing a folder for an agent on an SSH or WSL host now works when the side panel and a new-session welcome are both open. * MCP servers passed by an ACP client in `session/new` / `session/load` are now usable by the agent and listed in `/mcp`, including for HTTP and SSE MCP servers **Devin Desktop** * Restricted Mode blocks restricted workspace settings written in nested object form, not just the dotted form (CVE-2026-81376). * Switching back to one of your 10 most recently viewed sessions shows its transcript immediately. **Devin Desktop** * Dragging files from the Explorer onto the agent panel, or sending an editor selection to chat, adds them to the composer again. * Remote SSH sessions open right after a reload or relaunch, without a "session is locked by another process" error. * Devin Fusion can be activated even when Claude Fable 5.1 isn't available as a lead model.

Introducing Fusion in Devin Desktop and Devin CLI

**Devin Desktop** * **Remote agent hosts:** connect to agents over SSH from the location selector, with saved hosts, status dots, and a server icon in the sidebar. SSH sessions recover the exact transcript after a reconnect. * Local sessions can now be deleted from the agent sidebar. * Faster startup, bounded memory for background transcripts and streamed file writes, and cheaper loading spinners. * When switching between sessions in the Agent Command Center, the file explorer now updates to match the working directory of the active session. * ACP is always enabled — the **Enable ACP** toggle is gone. * MCP authorization opens the provider directly, and Docker-based MCP servers from the registry launch correctly. * Agent activation failures report the agent's last stderr line and open that agent's output channel. * Some legacy Cascade entry points are removed: new-agent option, annotations, conversation mentions, settings group, automatic Lifeguard checks, Vibe & Replace, Deploy, and workflow commands. * Files Devin edits in Desktop count toward lines-of-code analytics. **Devin Cloud** * Network access requests now match the web app: an "Allowlist N domains" card that names the policy blocking the destinations and lets permitted users update the governing security profile or automation. * Archiving a cloud session with open pull requests offers to close them, and archives its child sessions. * Improved cloud session formatting with an image preview carousel, hook run visibility, and rich queued messages. * A message sent during a Devin Cloud outage is held and delivered when the connection returns. **Devin Desktop** **Cascade** has been removed. [Devin Local](https://docs.devin.ai/desktop/devin-local) is now the only agent available in Devin Desktop. Use the **Continue in Devin Local** prompt to migrate existing conversations to the new agent. * The agent location picker now shows **Local**, **Worktree**, and **Cloud** as top-level options, with existing worktrees in a searchable nested submenu. * Agent sidebar: sessions updated in the last 30 days are shown by default. * The agent inbox list view now has per-row checkboxes for batch archive/unarchive, and the title-bar back/forward arrows navigate between the inbox and opened sessions. * Trigger menus (`/`, `@`, `!`) no longer open when followed by whitespace, and stay closed after you click into the conversation. * Cmd/Ctrl+F opens find-in-page in Devin Review and embedded Devin web surfaces. Devin Review tabs show the PR title, open GitHub links at their diff anchor, and the sessions sidebar swaps to a PR files/review sidebar (or the wiki page tree) while a fullscreen review or wiki is open. * PR cards gained **Open Devin Review**, **Open in Desktop tab**, **Close PR**, and **Git settings** actions, and **Checkout branch** now finds local clones (including worktrees) and lets you pick one when several match. * Fixed attaching to dev containers whose remote user is a `uid:gid`, Remote-WSL activation on a fresh install, and MCP registry fetches behind corporate proxies. * Clipboard images can be pasted into the New Session page. * Problems panel actions now send problems to Devin Local when Cascade is disabled. * Config changes reach sessions in the order they are selected, so a rapid sequence no longer lets an older update overwrite a newer one. **Devin Desktop** * The Agent Command Center now follows whichever space is selected instead of being tied to one folder, converts an editor window in place (no reload, no save prompt), and any number of agent windows can run side by side. * A new **Agent Command Center location** setting (`devin.agentWindow.location`) can be used to split the agent command center into a separate window from the editor. * Significantly improved performance for switching between Agent and Editor mode (Ctrl/Cmd+G). * Improved update process on Windows to only install after explicitly clicking **Restart to Update**. * Windows: **Install Devin CLI** now writes a shim to the bundled CLI, so updating Devin Desktop updates the `devin` command too. * Linux: uninstalling or upgrading the `.deb` no longer removes the shared Microsoft apt keyring, so other repositories signed by it keep working. * The agent sidebar, composer, and welcome page now warn when a workspace is untrusted and offer a **trust workspace** prompt to activate local agents. * Fixed a rare bug where the window could scroll up after a mode switch. * Improved recovery for corrupted `file://` working directories. * Added the ability to rename sessions from the tab dropdown. * Enterprise: Added a link to request more usage when hitting ACU limits. **Devin Local** * Added support for working on multi-root workspaces containing virtual filesystem folders. * Improved plan mode with a full Markdown plan file that can be separately reviewed, with an explicit **Implement** button. * Running subagents can be stopped individually without cancelling the turn. * **Explain and Fix Problem** sends problems to Devin Local when Cascade is disabled. * Devin Local tabs show the same status indicators as Cascade legacy tabs and the **Current Workspace** view keeps other projects' conversations out of the list. * `post_setup_worktree` hooks now run for worktrees created from a Devin Local session, so `.env` files and other untracked setup are copied in before the session starts. * New settings control whether integrated terminal activity and local user-edit activity are shared with ACP agents (both remain on by default). * `mcp_config.json` no longer shows spurious "Property is not allowed" warnings. * Up/down arrows in the chat input once again navigate through previous prompts. * Fixed the migration wizard to work in remote SSH workspaces. **Devin Cloud** * The sessions sidebar now has improved filtering and sorting controls. * Live shell output streams into the session while a command runs, and finished shell rows expand to their full command and complete output. * Terminal cards follow the newest output instead of the oldest, transcript timestamps appear on hover, and a failed send restores your draft to the input instead of losing it. * Session tabs and the command palette offer **Copy Session URL**. * Saving a session's network config now reports a conflicting change instead of silently discarding it, and approving a network access request says why it failed. **Devin Desktop** * Faster sidebar for users with thousands of cached sessions: filtering, space grouping, and sorting now only process the sessions actually fetched for display, eliminating multi-second lag after "Reload Window" or while scrolling. * Sessions appear immediately on startup: the agent sidebar and the Sessions board and list views are pre-populated from a per-session cache while the first session list request is still in flight. Mode and model selections, per-turn stats footers, turn and Fast Context feedback indicators, and pending in-editor diff review state now refresh from the server instead of being restored across restarts. * Automation and scheduled sessions are filtered on the server when the connector supports it, and fall back to the local filter otherwise. **Devin Local** * Fixed authentication issues with certain MCP servers, such as self-hosted GitLab servers and older Atlassian MCP instances * `/share` no longer asks which organization a conversation belongs to: shared conversations are scoped to your account, so the link works for everyone in the account, and refusals now explain the server's actual reason (for example, that conversation sharing is disabled) **Devin Desktop** * "Restart to Update" now asks for confirmation when local agents are still working and says how many will be stopped; cloud sessions keep running. * Settings and Keyboard Shortcuts open as regular editor tabs by default; set `"workbench.editor.useModal": "all"` to keep the modal overlay. * Fixed a bug with accidentally triggering editor keybindings from the agent chat. * The old "Plugins" section for IDE extension marketplaces has been renamed to "Extensions". * Hide Cascade-specific configuration and customization options when Cascade is disabled for your team. * Visual polish for the Agent Command Center: left-aligned titlebar, unsaved-changes indicator on file tabs, no more Cmd+P open/close flicker, aligned PR icons in Quick Open, full-width sidebar title renaming, and dragged session tabs that pick up their session name. * Starting an agent in a new worktree that fails now surfaces the git error instead of quietly running in your workspace. * **Terminal: Create New Terminal in Editor Area** now works inside worktrees. * Codemaps and MCP configuration files now open from the remote machine when connected over WSL, SSH, or a dev container. * Teams plan members no longer see quota warning banners they cannot act on. **Devin Local** * Devin Local conversations can be shared: **Share Conversation** uploads a sanitized transcript (system prompts and tool definitions dropped, secrets redacted, paths normalized) and copies a team-visible link. Share directly from the actions menu below a completed turn. * Reverting is reliable mid-turn: revert buttons appear as soon as a prompt is sent and reverting while the agent is working cancels the turn first. * The Customizations panel has search across every section (skills, subagents, rules, hooks, plugins, MCP servers), a new **Subagents** section, a refresh action for plugins, and an info indicator explaining why an enterprise-required plugin can't be removed. * Plugins installed from Customizations are added to your personal plugins by default, so they are available in Devin Cloud and on your other devices; choose **Install locally** for a device-only install. * Permission rules from different levels (enterprise, mode, user, project, subagent) now compose predictably — an explicit `deny:` always wins, "always allow" options only appear when the grant would actually take effect, and denials say which layer denied them. * Fixed rendering of commands whose output contains non-UTF-8 bytes. * Ensured `sudo` password prompts can't hang a command. * Separate each MCP server's logs into its own `MCP: ` output channel. * Large-file reads through ACP are bounded and paginated instead of repeatedly rereading overflow files. Late terminal flushes now preserve complete output and cannot reopen completed command cards. **Devin Cloud** * Session size chips use the same enterprise ACU thresholds as the web app, and auto-continuation billing notices appear inline in the transcript. * Queued messages can be edited: click the edit button or press ⬆ in an empty input to pull the last queued message back. * The `+X −Y` diff summary on a collapsed agent group is now clickable and opens a multi-diff editor with just that group's files. * "Duplicate session" and "send as fork" open the fork in a new tab, keeping the original conversation open. * "Grant access" on a network access request is disabled with an explanation when an admin owns the session's network policy. **Fixed** * Devin Desktop for Windows loads root and intermediate certificates from the Windows certificate store again, so sign-in and other HTTPS requests no longer fail with `self signed certificate in certificate chain` behind a TLS-inspecting proxy or a corporate root CA. * The `edit`, `write`, `apply_patch`, and `notebook_edit` tools in Devin Local now refuse to write through a symlink, so an approved edit can no longer be redirected to an unexpected file. **Devin Desktop** * The Codemaps icon is back in the activity bar in Agent Command Center mode, and opens Codemaps in an editor tab. * Closing the last tab in the agent panel now closes the panel instead of opening a blank tab. * Agents and hooks are disabled while a workspace is open in Restricted Mode, and are re-enabled when you trust the workspace. * Rules and workflows now use Devin branding, and workflow surfaces explain that workflows are being deprecated in favor of skills and link to the migration flow. * Product analytics are no longer started before your account status resolves, so telemetry is never collected for accounts that have it turned off. **Devin Local** * Added a guided Cascade Migration Wizard that helps you migrate hooks, workflows, and memories, with per-item selection, reviewable results, and a completion screen. The wizard skips archived memories and simplifies workflow migration choices. * Devin Local customizations now includes a Plugins section where you can review, install, and remove plugins and see the skills, rules, hooks, and MCP servers they provide. * Added "Open customizations" entry points to the new-tab menu and Devin Local session context menu. Agent actions menus now show customization options that match the open session. * MCP servers from Devin CLI plugins and project-level configurations now appear in the Devin Local MCP UI, including multi-root workspaces. Servers that need authorization now have an **Authenticate** button to restart the OAuth flow. * Remote agent sessions can now open a browser preview inside Devin Desktop, with captured elements and console output available as pending context in the agent composer. * Models marked "Devin Local only" now appear disabled in Cascade's model picker with a tooltip directing you to Devin Local. * Implementing a plan now continues in its originating agent session when it is available, preserving the session's conversation context. * Editable run-command permission cards now use a quieter visual treatment, avoid layout shifts while editing, and support Enter to confirm, Shift+Enter for a newline, and Escape to cancel. **Devin Desktop** * Added a unified notifications setting that posts native OS notifications when any agent session finishes or needs your input. * Codemaps now open in their own editor tabs in agent window mode (home, generation, and individual codemaps), and codemap @-mentions now work in Devin Local. The Codemaps icon is also back in the activity bar in Agent Command Center mode. * Select text inside a message transcript and add it to the chat input with the "Add to chat" button or ⌘L / Ctrl+L. * Added keyboard shortcuts for permission requests (always-allow and reject), with the shortcut hints shown on the buttons and dropdown entries. * Refreshed the agent window UI: Inter font by default, web-app icon set at web-app sizing, rounded pill session tabs (with state/PR icons), and smarter pane placement so files no longer cover your session tabs. * Pull request editor tabs now show a state-specific icon (open, draft, merged, or closed), and session-create cards show a Devin mode badge (Fast, Ultra, Fusion). * Faster syntax highlighting for streaming diffs, and typing in the input no longer lags while other background sessions stream. * Agent sidebar improvements: right-click context menus, double-click to rename, per-workspace filters/sort/grouping, greyed-out locked (read-only) sessions, a new-session shortcut hint, and sticky grouped spaces that keep their header. * Signed-out session tabs now show a "You are signed out" sign-in prompt instead of an endless spinner, and logging out cleans up stale session tabs. * Editing a past message keeps consistent typography, and the edited prompt stays visible at the bottom after a revert. * Cascade, Devin Local, and every other ACP agent are now unavailable while a workspace is open in Restricted Mode, and hooks no longer load or run there. * Devin Local customizations has a new Plugins section listing the plugins it loads and the ones your repository, organization, or account offers. * Remote agent (ACP) sessions can now open a browser preview, the same workflow Cascade has: the agent proxies your local dev server, and the elements and console output you capture land in the agent's message box as pending context. In Devin Desktop the preview opens in the built-in browser pane next to the agent. * "Open customizations" is now available from the new-tab menu in an agent space and from a Devin Local session's sidebar context menu, and the Cascade panel's `...` menu now only offers the customization surfaces that apply to the agent you have open. * MCP servers reporting "Needs auth" now show an **Authenticate** button in the Devin Local MCP list, marketplace card, and detail page, which clears the stored OAuth credentials and reruns the browser authorization flow. * Models marked "Devin Local only" (including every GPT-5.6 variant) now appear disabled in Cascade's model picker with a tooltip pointing you to Devin Local, rather than running degraded in Cascade. * Closing the last tab in the agent panel with the tab "x" now closes the panel instead of reopening a blank tab, matching Cmd/Ctrl+W. * Updated the base IDE to VS Code 1.126 **Devin Local** * New "Devin: Open Cascade Migration Wizard" command opens a guided wizard that chains hooks → skills → memories migration in one flow, with per-item opt-in and dry-run previews. * Plan mode now works like Cascade's: the agent researches with read-only commands, keeps a persistent Markdown plan file at `~/.devin/plans/plan-.md`, and asks for approval before implementing. * Worktree sessions now show a **Merge** button to bring their changes back into the workspace, and you can pick an existing worktree from the agent location selector's Local submenu. * New tabs now default to Devin Local when you haven't chosen a preferred agent (falling back to Cascade if it isn't available), and Local is selectable in the agent selector while it's still connecting. * `Megaplan` now work in Devin Local, switching the session into Plan mode and prompting the agent to plan first. * Editable command approvals: click a command in a permission card to edit it before approving, or use the wand action to describe a change in plain language and have a fast model rewrite it for review. * Queued messages can now be edited before they send, and editing or reverting a prompt preserves file, directory, skill, and terminal @-mentions. * Added Rules to the @-mention menu so you can pull a manual-trigger rule into a conversation. * Added a "Duplicate session" action to the response footer to branch off a conversation, and a "Subagents (Preview)" toggle in Devin settings. * Custom subagents can now be defined as flat `agents/.md` files, and per-agent directories also accept `AGENTS.md`, `agent.md`, and `agents.md`. * Response statistics now appear reliably after every turn. * With "Agent Diff Zones" turned off, Devin Local no longer opens edited files in the background, and closing the last Devin Local tab now opens a fresh session instead of closing the panel. * Fixed streamed `write`/`edit` previews creating stray fragment files when a filename contains underscores. * Fixed permission rules written with relative globs (e.g. `Read(**/*.pem)`) being pinned to the directory the CLI was launched from, so they now apply under every workspace directory and pick up directories added mid-session. * Session permission grants and mode switches answered on a subagent's prompt now apply to the whole session, so the root agent and sibling subagents no longer re-prompt for a scope you already granted. **Devin Cloud** * Improved performance for loading Devin Cloud sessions. * Devin Cloud sessions now show the server-side send queue, kept in sync with the web app; Cmd/Ctrl+Enter queues the next message on the server. * Multi-user (Slack) sessions now show each participant's name above their messages. * A "Copy link" action was added to cloud session menus. * A "Remote ACP is disconnected" banner with a Reconnect action now appears when the Cloud connection drops. **Devin Desktop** * `@`-mention pills in Cascade now show type-specific icons. * Restyled the command palette in the Agent Command Center. * Hiding the status bar by default in the Agent Command Center (set `"workbench.statusBar.visible": true` in user settings to restore it). * New worktree-backed sessions now open instantly and stay interactive while the worktree is created in the background. * "View usage" now opens eligible Devin users' personal analytics page directly. * The `devin.*` settings for gitignore access, completion mode, and auto-continue are now honored. * Resuming an agent session now uses its original working directory, so Claude sessions started in another folder can be reloaded. * Fixed a crash when opening the Recent Chat History modal in Cascade. * On Windows, the auto-updater now clears stale `Devin.exe` processes before applying updates. **Devin Cloud** * Long Devin Cloud sessions render, scroll, and type faster and stay responsive while streaming. * A brief remote-connection drop no longer flashes a "disconnected" banner. * You can now configure a session's network policy and grant or deny network access requests inline from the chat, without switching to the web app. **Devin Local** * Devin Local customizations and the sidebar skills count now span all open workspace folders. * The Hooks tab in Devin Local Customizations now lists configured hooks with their source and trigger events. * Added a command to migrate Windsurf hooks into Devin hooks across every workspace folder. * Added a subtle timeline navigator for Devin Local sessions. * Added Fast Context support in Devin Local sessions. Fixes issues with diff viewing in autonomous mode. **Devin Desktop** * Added "New session in space" to the session kebab menu. * Devin Cloud sessions now auto-reconnect when the network returns. * Images can now be copied from chat via the context menu. * New users now default to agent mode. * The agent sidebar now stays visible when sending problems or explain-and-fix to Cascade in agent window mode. * Fixed branch checkout silently failing to open a worktree. * Very large sessions no longer crash the window when reading or writing the session event cache. * The "Scroll to top" button in long sessions now has a solid background so it stays visible in dark themes. * Orphaned Devin ACP agent processes are now detected and cleaned up on startup, including on Windows. * Fixed analytics connection failures under TLS-intercepting proxies. **Devin Local** * Edits produced in autonomous mode now produce reviewable diffs. * ACU usage is now shown in the `/usage` command. * Skill `permissions:` frontmatter now applies to auto-approvals. * Enterprise login policies are now enforced in the CLI. * Added a `sandbox.excluded` allow/ask/deny config (user and team settings) to run specific commands outside the sandbox; excluded commands also skip the sandbox proxy environment. * Fixed command approval parsing for PowerShell `$variable` assignment prefixes. **Devin Desktop** * Devin ACU usage is now displayed in the client. * Fixed settings and extensions migration for Windows system-wide installs. **CLI and Devin Local** * On Windows, `bash` now resolves to Git Bash instead of the WSL launcher stub. * Subagents can now be configured with a default model. * The MCP registry cache is now warmed during startup, so MCP servers are ready sooner. * Injected context is no longer included in auto-generated session titles. * Fixed agent messages over-merging in Claude ACP sessions. * Added an `attribution` option to the Devin Local [config file](/cli/reference/configuration/config-file); set it to `false` to suppress Devin mentions in commit messages. Various bug fixes and improvements. **Fixed** * Made MCP registry parsing more tolerant of old and inconsistent schemas. **Fixed** * Fixed a bug with loading skill files that use alternative fields. **Outdated:** this entry refers to the `devin plugin` command, which has since been renamed to `devin plugins`. The singular `devin plugin` is no longer accepted. See [Plugins](/cli/extensibility/plugins/overview) for current usage. The 3.2 series brings Devin Local enhancements and continued Devin Desktop polish. **Devin Local** * Added a [`devin plugin`](/cli/extensibility/plugins/overview) system for extending Devin Local — in preview and opt-in for enterprises. * Subagents can now call MCP tools directly. * Teams can enforce terminal allow/deny lists through CLI permission scopes. **Agent and Editor modes** * Enabled the `Cmd+.` mode-toggle shortcut from the empty editor welcome panel. **Other improvements** * Improved handling for less common MCP server features. * Removed the Explain sparkle button from the editor breadcrumbs. 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.

Reset migration from Windsurf command in the command palette

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. * 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. ![Devin Cloud selector](https://exafunction.github.io/public/images/windsurf/devin-cloud.png) ## 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. ![Adaptive model picker](https://exafunction.github.io/public/images/blog/windsurf-adaptive/adaptive-model-picker.png) # 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 `devin.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 announcement banner

# 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.

1.9544.24 Windsurf Wave 14 Arena Mode Changelog Banner

## 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 1.13.8 GPT-5.2 Codex model changelog banner

1.13.8 GPT-5.2 Codex model changelog banner

# 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. 1.13.3 Windsurf Wave 13 Merry Shipmas Changelog Banner

1.13.3 Windsurf Wave 13 Merry Shipmas Changelog Banner

## 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 1.12.43 GPT-5.2 changelog banner

# 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 1.12.39 GPT-5.1 Codex Max changelog banner

1.12.39 GPT-5.1 Codex Max changelog banner

# 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. 1.12.36 Claude Opus 4.5 changelog banner

1.12.36 Claude Opus 4.5 changelog banner

# 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 1.12.31 GPT-5.1 and GPT-5.1-Codex changelog banner

1.12.31 GPT-5.1 and GPT-5.1-Codex changelog banner

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 allowlist 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.com/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 changelog banner

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 1.12.1 changelog banner

* **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 1.11.5 changelog banner

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 1.11.1 changelog banner

Windsurf now supports Kimi K2 model which costs 0.5 credits per prompt. # Speak to Cascade 1.11.0 changelog banner

## 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 1.10.3 changelog banner

* 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 1.9.2 changelog banner

## 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 1.9.0 changelog banner

## 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 1.8.2 changelog banner

## 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 1.8.0 changelog banner

## 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 1.7.2 changelog banner

## 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 1.7.0 changelog banner

## 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 1.6.5 changelog banner

## 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 1.6.4 changelog banner

## 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 1.6.1 changelog banner

## 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 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.