Summary: Windsurf, the AI code editor, was renamed Devin Desktop by Cognition on June 2, 2026, and a lot of "Windsurf not working" searches since then come from the rename itself: a new app name, a new terminal command, new docs and a new quota system. This guide walks through the problems Cognition's own troubleshooting pages list, from "stuck on the Free tier" and rate limits to the macOS "damaged" pop-up, Linux launch crashes and a stuck Cascade terminal, with the fix the docs give for each. It closes with a plan table so you can tell a real bug from simply running out of quota.
First, rule out the rename
Cognition's Devin Desktop FAQ says Devin Desktop is "the new name for Windsurf": the same IDE, editor and features, delivered as a normal over-the-air update. Your settings, extensions and plan carry over, and the FAQ states that pricing did not change because of the rename. What did change can look like breakage if you were not expecting it:
- The app has a new name. It now appears as
Devin.appon macOS,Devin.exeon Windows andDevin/devinon Linux. If your company's device management only allows "Windsurf", the renamed app can be flagged or blocked. The FAQ tells IT teams to add Devin to the allowlist. - The
surfcommand was replaced. The new terminal command isdevin-desktop. Install it from the command palette with "Shell Command: Install 'devin-desktop' command in PATH". The oldsurfandwindsurfcommands still ship in~/.codeium/windsurf/bin/, and the FAQ suggestsalias surf="devin-desktop"if your scripts depend on the old name. - The Agent Command Center opens first. The multi-agent view is now the default surface. The classic editor is still there; nothing was removed.
- New data folders. On first launch the app offers "Migrate from Windsurf", which copies settings, keybindings, snippets, workspace state and extensions into new paths such as
~/.config/Devin/on Linux or%APPDATA%\Devin\on Windows. Caches, logs and Local History are deliberately skipped. If you chose "Start fresh", nothing is copied, which explains a sudden "where did my settings go" moment. - The docs moved. Documentation and the changelog now live on
docs.devin.ai. Olddocs.windsurf.comlinks redirect there.
Your rules also keep working. Devin Desktop still reads the legacy .windsurfrules file and .windsurf/rules/, and adds .devin/rules/, which takes precedence when both exist. It also reads AGENTS.md and can import .cursor/rules files.
Account and usage problems
"I paid for Pro, but I'm still on the Free tier"
The official fix is a short sequence: wait a few minutes for the upgrade to sync, then log out of Devin Desktop on the website, restart the IDE, and log back in. Also make sure you are running the latest version. You can confirm your plan by clicking the Devin Desktop widget in the status bar and opening the "Plan Info" tab, or under Settings > Usage & limits.
Rate-limit errors on premium models
The troubleshooting page is candid here: Cognition is subject to rate limits from the model providers it uses and "sometimes hit[s] capacity" on premium models. The advice is to wait a few moments and try again. If the error keeps returning on one frontier model, switching to another model for the task is a practical workaround.
"I hit my limit" is not a bug
In March 2026 the product replaced prompt credits with a quota system. Each plan now has a daily and a weekly allowance that refreshes automatically, measured by how many tokens each request uses, so cost varies by model and by how much context you send. Free models do not count against the quota. When you run out, Free users wait for the next daily or weekly reset; Pro, Teams and Max users can buy extra usage, billed at API list prices. The quota page notes that the daily allowance is more than one seventh of the weekly one, so weekend coders can still use the full week.
To stretch your quota, the docs recommend precise prompts with less unnecessary context, using the lower-cost SWE models for routine tasks, avoiding long sessions when a quick prompt will do, and sticking to one frontier model so caching can cut token use.
Install and launch errors
macOS says "Devin Desktop is damaged and cannot be opened"
Cognition calls this a false positive in macOS security. Try these in order:
- Open System Settings > Privacy & Security and click "Allow" or "Open anyway".
- Make sure the app lives in
/Applicationsand you launch it from there. - Check that you downloaded the right build: Intel for Intel Macs, Apple Silicon for M-series Macs.
- Download the DMG again from the official page, since the check is usually triggered at download time.
- With the app and the pop-up closed, run
xattr -c "/Applications/Devin.app/".
Windows updates don't appear
If you see "Updates are disabled because you are running the user-scope installation of Devin Desktop as Administrator", the app cannot auto-update while elevated. Start it normally, with user scope, and the update can install.
Linux: the app silently doesn't start or crashes on launch
With the tarball install, this is usually an Electron sandbox permission issue that VS Code shares. The documented fix is to give the bundled chrome-sandbox the right owner and mode:
sudo chown root:root /path/to/windsurf/chrome-sandbox
sudo chmod 4755 /path/to/windsurf/chrome-sandbox
Launching with --no-sandbox also works, but Cognition does not encourage it.
"Devin Desktop failed to start" or a blank Cascade panel
The docs suggest deleting the Cascade data folder, ~/.codeium/windsurf/cascade on Linux and macOS or C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade on Windows, then restarting. Be warned: this removes your conversation history and local settings, so treat it as a last step.
Linux: "no space left on device" with plenty of disk space
This one confuses many people. The language server watches workspace files with inotify, and when the kernel's watch or instance limit is used up, Linux returns an ENOSPC error that reads like a full disk. The app opens, but the language server exits right away and AI features stop working. Check your limits with cat /proc/sys/fs/inotify/max_user_watches and cat /proc/sys/fs/inotify/max_user_instances. The docs say typical defaults are 8,192 watches and 128 instances. A temporary fix is:
sudo sysctl fs.inotify.max_user_watches=524288
sudo sysctl fs.inotify.max_user_instances=1024
To make it permanent, append both lines to /etc/sysctl.conf and run sudo sysctl -p, then restart the app. Note the trade-off the docs mention: 524,288 watches can use roughly 512 MB of kernel memory.
Editor and agent quirks
The Cascade terminal looks stuck after a command finishes
Three causes are documented. First, no default terminal profile is set: open Settings, search "terminal default profile", and pick zsh, bash or PowerShell for your OS. Second, a heavy zsh theme such as Oh My Zsh or Powerlevel10k can make the agent think a command is still running; comment out the theme lines in ~/.zshrc to test, and keep a minimal config for the app's terminal if that fixes it. Third, on newer Linux distributions (reported on Fedora 43 and later), systemd "terminal context tracking" emits extra escape sequences that confuse output parsing; the workaround is not sourcing /etc/bashrc from ~/.bashrc, or using a minimal shell config for the app.
Python highlighting is broken or Pylance won't work
Microsoft's Pylance is not the supported path here. Search the extensions panel for "Windsurf Pyright", or paste @id:codeium.windsurfPyright, to install the dedicated extension.
Remote SSH fails with "Undefined error: 0" on macOS
If SSH works from Terminal but fails inside the app, macOS is blocking the app's Local Network access. Go to System Settings > Privacy & Security > Local Network, enable Devin Desktop, and restart. If it isn't listed, try connecting once to trigger the permission prompt; reinstalling re-triggers it if you dismissed it earlier.
Behind a VPN, proxy or firewall
Connection problems on restricted networks usually come down to blocked domains. The docs list the backend domains to allow for all customers, including .codeiumdata.com, update.windsurf.com, .windsurf.com, .codeium.com, .googleapis.com, apis.google.com and static.devin.ai. Separate pages cover proxy settings and TLS inspection tools such as Zscaler.
When nothing works: send diagnostics
Before contacting support, open the agent panel, click the three dots in the top-right corner and choose "Download Diagnostics". The official screenshot of that menu is included at the end of this post.
Plans at a glance
If your "error" is really a quota wall, this is what each individual plan includes, taken from the official pricing page today.
| Plan | Price | Usage | Key details |
|---|---|---|---|
| Free | $0 | Light quota; wait for the daily or weekly reset | Limited model availability, no premium models, unlimited Tab completions and inline edits, SWE-2 at slow speed |
| Pro | $20/month | Increased quotas plus paid extra usage at API pricing | Full model availability, including frontier models; free use of SWE-2; access to Devin Cloud agents |
| Max | $200/month | Significantly higher quotas | Everything in Pro, aimed at power users |
| Teams | $80/month plus $40/month per full dev seat | Each full seat has its own quota | Up to 200 users, centralized billing, admin analytics, priority support |
Existing subscribers kept their older prices when quotas arrived: the quota page says Pro at $15/month and Teams at $30/seat/month are grandfathered indefinitely. Leftover add-on credits were converted to extra-usage balance at $10 per 250 credits, and that balance can be refunded through support.
Editor's note
Who this is for: anyone who used Windsurf and now sees "Devin" everywhere, and developers on Linux or locked-down work laptops, where most of the documented launch problems live.
Who it's not for: users of the Windsurf JetBrains plugin. The FAQ says that plugin is in maintenance mode and newer JetBrains releases can break it; Cognition recommends moving to Devin over the Agent Client Protocol instead.
Gotchas I noticed while checking the docs: the Cascade reset folder path still says "windsurf", so don't go looking for a "devin" folder there. Free trials of paid plans are not offered, though the Plans and Usage docs say you can request a refund before you use a subscription. And the pricing page's Free column shows no premium models, so a Free user seeing only some models is not a bug.
FAQ
Is Windsurf discontinued?
The name is. Cognition's FAQ says Devin Desktop is the same IDE under a new brand, with settings and plans carried over. Older Windsurf releases can still be downloaded, but Cognition treats every release but the latest as deprecated.
Do I have to use the Devin cloud agent?
No. The FAQ says you can keep using Devin Desktop with local-only agents. Devin Local is the new local agent, a rewrite that inherits your Windsurf settings, and the launch post said the legacy Cascade agent would remain available through July 1 for gradual migration.
Why does my usage run out faster on some days?
Quota is spent per token, so large codebases in context, long sessions and expensive frontier models drain it faster. Free models don't count at all, and the docs say requests to the same model benefit from caching.
Related guides
If you'd rather run an open-source agent inside VS Code with your own API key, see our Cline tutorial on planning, acting and rolling back. Terminal-first coders can compare notes with Aider fixes for edit, token and API key errors. And for a free assistant in the editor you already use, read how to use GitHub Copilot Free in VS Code.
Most "Windsurf is broken" moments after June 2 turn out to be the rename, a quota reset or a Linux permission, so check those three before reinstalling anything.
Image credits: Devin Desktop launch image from the official Devin blog, the "Download Diagnostics" menu image from the Devin Desktop docs, and screenshots of the public devin.ai pricing page captured on 2026-10-30; see them at the end of this post.
Last verified: 2026-10-30
Sources:
- Windsurf is now Devin Desktop (Devin blog) and Introducing Devin Desktop (Cognition)
- Devin Desktop FAQ
- Common Devin Desktop Issues and Linux inotify limits
- Quota-Based Usage and Plans and Usage
- Devin plans and pricing
댓글
댓글 쓰기