Windsurf Troubleshooting: 10 Errors and Fixes (2026)
Jump to your symptom: plan not updating · "is damaged" warning on Mac · Windows update blocked · won't open on Linux · "failed to start" · remote SSH error · blocked by firewall or VPN · blank agent panel · terminal stuck "running" · no Devin Local / still looks like Cascade
Before You Debug Your Project: 4 Quick Checks
- Confirm which app you're actually running. Windsurf became Devin Desktop on June 2, 2026 (version 3.0.12), delivered as a normal over-the-air update: your plan, pricing, extensions and keybindings carried over automatically. If your screen looks different from an old tutorial or screenshot, you've simply been updated, not broken.
- Check which agent the problem is actually in. Cascade, the agent Windsurf used to ship with, was removed on September 8, 2026 (version 3.9.19). Devin Local is now the only agent. Look at the agent selector in the bottom-right corner of the editor: if it's missing or still references Cascade, see Error 10 before troubleshooting anything else.
- Restart Devin Desktop completely, not just the current window. Several of the fixes below start with a full restart after a settings or login change, and it rules out a large share of stuck states on its own.
- Pull a diagnostics file before you dig further. Open the agent panel, click the three dots in the top right, and choose Download Diagnostics. If you end up contacting support, attach this file — it's the same thing support will ask for first.
Error 1 - Your Pro or Teams Plan Isn't Reflected After You Upgrade
What you see: you upgraded your subscription, but Devin Desktop still shows the old (usually free) tier, with the same limits as before.
Why it happens
The app's local session doesn't always pick up a plan change immediately, especially if you upgraded from the website while the desktop app was already open and logged in.
How to fix it
- Log out from windsurf.com/settings (account settings still live at this domain).
- Fully restart Devin Desktop.
- Log back in, and confirm you're on the latest version of the app before assuming the plan itself is wrong.
What you should see: your account menu reflects the new tier and its limits.
Error 2 - "Devin Desktop Is Damaged and Cannot Be Opened" (Mac)
What you see: on macOS, trying to open the app (often right after downloading or updating it) triggers a Gatekeeper warning saying the app is damaged.
Why it happens
This is macOS's standard quarantine check on a downloaded app, not actual file corruption.
How to fix it
- Go to System Settings → Privacy & Security and look for an "Allow Anyway" / "Open Anyway" option for Devin Desktop.
- If that option isn't there, open Terminal and run
xattr -c "/Applications/Devin.app/", then try opening the app again.
What you should see: the app opens normally on the next launch attempt.
Error 3 - Windows Blocks the Update: "Updates Are Disabled Because You Are Running the User-Scope Installation"
What you see: on Windows, the app refuses to self-update and shows this exact message.
Why it happens
The message is telling you directly what's wrong: a per-user installation (installed just for your Windows account, without admin rights) can't apply the automatic updater the same way a machine-wide installation can.
How to fix it
- If you have admin rights on the machine, reinstall Devin Desktop using an installer run as administrator, so it installs system-wide instead of per-user.
- On a managed work machine, ask IT to push the system-wide package rather than installing it yourself as a standard user.
What you should see: updates apply automatically going forward, without the message reappearing.
Error 4 - Devin Desktop Won't Open on Linux, or Crashes Right After Launch
What you see: on Linux, the app either does nothing when you launch it, or opens and immediately crashes, often with no visible error.
Why it happens
This is commonly a sandbox permissions problem with the bundled Chrome sandbox binary, not an issue with your project.
How to fix it
- Locate the
chrome-sandboxfile inside your Devin Desktop installation folder. - Run
sudo chown root:root /path/to/windsurf/chrome-sandboxand thensudo chmod 4755 /path/to/windsurf/chrome-sandbox, replacing the path with your actual install location. - Relaunch the app.
What you should see: the app opens and stays open.
Error 5 - "Devin Desktop Failed to Start"
What you see: a generic startup failure message, on any operating system, often after an update.
Why it happens
This usually comes from a corrupted local agent/session cache left over from a previous version, rather than a broken install.
How to fix it
- Close Devin Desktop completely.
- Delete the folder
~/.codeium/windsurf/cascade(on Windows:C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade). This clears cached agent state; it does not touch your project files. - Restart the app.
What you should see: the app starts normally, though you may need to sign in again.
Error 6 - Remote SSH Fails With "Undefined error: 0" (Mac)
What you see: connecting to a remote host over SSH from macOS fails with this exact, unhelpful error text.
Why it happens
Remote SSH in Devin Desktop needs local network access on macOS, and recent macOS versions block that by default per app.
How to fix it
- Go to System Settings → Privacy & Security → Local Network.
- Find Devin Desktop in the list and enable its toggle.
- Retry the SSH connection.
What you should see: the remote connection completes without the "Undefined error: 0" message.
Error 7 - Devin Desktop Doesn't Work Behind a Corporate Firewall or VPN
What you see: the agent can't reach the AI backend at all — requests hang, fail silently, or time out — specifically on a work network, VPN or restricted Wi-Fi.
Why it happens
Devin Desktop needs outbound access to a specific set of domains, and a corporate firewall or proxy that only allows an approved list will silently block everything else.
How to fix it
- Ask your network admin to allowlist:
*.codeiumdata.com,update.windsurf.com,*.windsurf.com,*.codeium.com,*.googleapis.com,apis.google.com,static.devin.ai,app.devin.ai,api.devin.ai,docs.devin.ai,docs.devinenterprise.comanddecagon.ai. - If you're on a VPN, test with it briefly disabled to confirm the VPN itself is the blocker before changing firewall rules.
What you should see: the agent connects normally once those domains are reachable.
Error 8 - The Agent Panel Is Blank
What you see: the agent panel (where you chat with Devin Local) shows nothing — no history, no input, just empty space.
Why it happens
This is a known display issue with the panel itself, not a sign that your conversation history or project was lost.
How to fix it
- Click the three dots in the top right of the (blank) panel and choose Download Diagnostics — this both forces the panel to re-render in many cases and gives you the file support will ask for if it doesn't.
- If it's still blank, fully restart Devin Desktop.
What you should see: the panel renders your conversation and input box again.
Error 9 - The Terminal Shows a Command as "Running" Long After It Finished
What you see: the agent ran a terminal command, the command actually completed, but the agent (or the terminal session) still shows it as in-progress.
Why it happens
Certain terminal profiles don't report completion status back to the agent reliably, so it keeps waiting on a signal that already happened.
How to fix it
- Open Settings (Cmd/Ctrl + ,) and search for the terminal default profile setting.
- Set an explicit default terminal profile instead of leaving it on auto-detect (this can also be set directly in
settings.json). - Restart the terminal session.
What you should see: new commands report as finished as soon as they actually are.
Error 10 - Devin Local Isn't Available, or Your Project Still Looks Like Cascade
What you see: you expect Devin Local (the agent that replaced Cascade) but don't see it in the agent selector, or your project still references Cascade-era behavior.
Why it happens
Cascade was fully removed on September 8, 2026; Devin Local should be the only agent available by default from that version onward. On an older install, or one that hasn't fully applied a settings update, the toggle for it can be missing or off.
How to fix it
- Check the agent selector in the bottom-right corner of the editor first — new conversations default to Devin Local when it's available.
- If it's not there, press Cmd/Ctrl+Shift+P, open Devin User Settings, go to the Agents tab, and toggle Devin Local on.
- Restart Devin Desktop.
- On a Teams plan, an admin may need to enable it org-wide at
app.devin.ai/org/<yourOrg>/settings/desktop, under Features, before it shows up for individual members.
What you should see: Devin Local appears as the agent for new conversations, using up to 30% fewer tokens than Cascade did for comparable tasks.
What Actually Changed When Windsurf Became Devin Desktop
A short timeline, because most of the confusion around this app right now comes from not knowing which of these already happened:
- June 2, 2026 (version 3.0.12): Windsurf was renamed Devin Desktop, following Cognition's acquisition of Windsurf in mid-2025. It shipped as a standard automatic update — your plan, pricing, extensions, keybindings and workflows carried over unchanged. The editor itself stayed backward-compatible with Windsurf and VS Code extensions.
- September 8, 2026 (version 3.9.19): Cascade, the local agent, was removed. Devin Local — a rewrite that shares its foundation with Devin CLI — is now the only agent in Devin Desktop.
- What's different in Devin Local: a permissions model of Deny/Ask/Allow instead of Cascade's auto-execution levels, a prompt for approval before any MCP tool call (MCP lets the agent use outside tools; this makes it ask first), support for git worktree sessions (isolated copies of your project for parallel edits), and a subagents feature (the agent can spin up helper agents for a subtask, defined as markdown files in an
agents/folder, behind a "Subagents (Preview)" toggle). - What doesn't carry over yet: Memories, Workflows, App Deploys and Arena Mode aren't supported in Devin Local. Memories and Workflows are meant to migrate to a newer "skills" system through the Devin: Open Cascade Migration Wizard command (Cmd/Ctrl+Shift+P); if you relied on either, run that migration before assuming your setup is simply broken.
When It Isn't a Bug
- A rate-limit message on premium models is a capacity constraint on in-demand models, not a defect in your project. Devin Desktop's own troubleshooting docs list it as exactly that, without a documented bypass.
- Memories, Workflows, App Deploys and Arena Mode not working under Devin Local isn't a bug to report — they're not supported by that agent yet. The question is whether your older Cascade-based setup needs a manual migration, not whether something broke.
- A UI that looks unfamiliar compared to an older screenshot or tutorial is almost always just the June 2026 rename and its interface changes, not a sign your install is corrupted.
What to Include When You Ask for Help
- The exact error text, copied, not paraphrased.
- Which agent you were using — Devin Local, or an older Cascade-era project you haven't migrated yet.
- Your operating system and whether the app was recently updated.
- The file from Agent panel → ⋮ → Download Diagnostics.
- Whether the problem started right around June 2, 2026 (the rename) or September 8, 2026 (Cascade's removal) — if so, say so, since it points straight at a migration issue rather than a fresh bug.
Frequently Asked Questions
Is Windsurf still called Windsurf?
Not as of June 2, 2026. Cognition, which acquired Windsurf in mid-2025, renamed it Devin Desktop in version 3.0.12. It arrived as a normal automatic update: your plan, pricing, extensions and keybindings stayed the same, and the editor remains backward-compatible with Windsurf and VS Code. The windsurf.com domain is still used for downloads and account settings.
What happened to Cascade?
Cascade, Windsurf's original local agent, was removed on September 8, 2026 (version 3.9.19). Devin Local, a rewrite that shares its foundation with Devin CLI and is up to 30% more token-efficient, is now the only agent in Devin Desktop. If your agent selector still shows Cascade-era behavior, press Cmd/Ctrl+Shift+P, open Devin User Settings → Agents, and enable Devin Local, then restart the app.
Why does Devin Desktop get stuck or show an error generating a response?
Devin Desktop's own troubleshooting documentation lists rate limiting — a capacity issue tied to premium models — as a known cause, without a documented workaround beyond waiting or trying again. If it keeps happening, open the agent panel, click the three dots, and choose Download Diagnostics before contacting support; that file is what support will ask for first.
Is Devin Desktop not working in WSL a known issue?
Devin Desktop's documentation separately lists a Docker container not showing up in Remote Explorer when using WSL as a known issue, without a published fix at the time of writing. If you hit that specific symptom, check you're on the latest version before assuming it's something in your project; for general connectivity problems in a work or VPN environment, see the firewall allowlist above.
My .windsurfrules file stopped being followed — is that a bug?
We couldn't find anything in Devin Desktop's official documentation confirming whether project rule files behave the same way after the Cascade-to-Devin Local switch. If yours stopped being followed, double-check it's still in the expected location in your project root; if it still doesn't work, that's worth raising with support directly rather than assuming it's expected behavior.
Sources
Checked on October 5, 2026:
- Devin Desktop changelog (rename date, Cascade removal date)
- Devin Desktop docs: Devin Local (agent selector, settings path, token efficiency, unsupported features)
- Devin Desktop docs: common issues (every numbered error above)
- Cognition: "Windsurf is now Devin Desktop" (rebrand announcement)
