Windsurf application data may mix temporary files with settings and conversation state. Do not remove an entire Application Support, ~/.windsurf or ~/.codeium directory as routine cache cleanup.
Start with your installed version
Record the application name and version before inspecting files. As checked September 23, 2026, the Windsurf documentation links below redirect to documentation labeled Devin Desktop. This guide does not assume that a newer product name, build or data location is interchangeable with the Windsurf version installed on your Mac.
Keep persistent data separate from cache
| Location or category | Review decision |
|---|---|
~/Library/Application Support/Windsurf/ | Mixed application state; never delete the whole directory as cache. |
| Library/Caches entries and update folders | Confirm ownership, version and contents; no blanket deletion approval. |
| Logs and diagnostic reports | Preserve while troubleshooting; review individually. |
~/.windsurf and ~/.codeium | Keep by default; folder names do not establish disposability. |
| Settings, keybindings, credentials and tool configuration | Keep. |
~/.codeium/windsurf/cascade/ | Keep conversation state. The vendor warns that deleting it removes conversation history and local settings. |
Step-by-step: inspect and preserve diagnostics
- Record your installed build and save work.
- For a fault, preserve diagnostics first. The current official troubleshooting guide describes Cascade’s three-dot menu → Download Diagnostics. Confirm the option exists in your build; review exported logs before sharing them.
- Quit the app before reviewing local storage. Compare folder sizes in Finder without removing files.
- Identify the owner and purpose of each candidate. Keep projects, conversations, settings, credentials and unknown items.
- Only follow a vendor reset procedure when it matches your specific problem and version, and you accept its stated data loss after backing up needed data. A destructive reset is not routine cleanup.
FAQ
Is it safe to clear Windsurf cache on Mac?
There is no blanket yes for application-data folders. Verify individual items; a folder named cache or tmp is not sufficient evidence.
Where should I check Windsurf storage?
Start by identifying the installed app, then inspect its application-data and cache entries. Treat the paths above as review starting points rather than verified deletion targets for every release.
Will cleaning Windsurf delete Cascade chats?
Deleting Cascade state can remove history and local settings. Keeping one known directory does not guarantee that all other files are disposable or that every version stores its data there.
Review with AI Agent Clean
Use AI Agent Cleaner to inspect categories and full paths if Windsurf is detected. Keep conversation and configuration data unselected, and do not treat defaults as compatibility certification. See pricing for current store terms.
Sources and verification limits
Evidence limitation: No version-specific deletion or restoration test is claimed. The linked documentation describes data purposes; it does not certify cleanup compatibility.
The official troubleshooting documentation was reviewed September 23, 2026 for diagnostics and its data-loss warning. We have not performed deletion and recovery testing on an installed Windsurf or Devin Desktop build for this revision. No safe-path list, recovered-space measurement or AI Agent Clean 1.0.8 compatibility guarantee is claimed.
Related guides and features
- AI Agent Cleaner — product page
- What’s New in 1.0.1
- Clear GitHub Copilot cache on Mac
- Clear Gemini CLI cache on Mac
- Clear Cursor cache on Mac
Preview Windsurf cache sizes locally — no cloud upload.
View on the Mac App Store