How to pause Windsurf on Mac
Windsurf runs Electron helpers, language servers, and Cascade MCP servers defined under ~/.codeium/windsurf/. Here is how to quit it cleanly or pause it together with the rest of your Mac AI stack.
What AI Stopper detects for Windsurf
- macOS app bundle:
Windsurf.appin/Applicationsor~/Applicationsand all child helpers - Snapshotted MCP config:
~/.codeium/windsurf/mcp_config.json
How to stop Windsurf manually on macOS
- Save open files and let any active Cascade edits complete before interrupting.
- Press Command + Q to quit
Windsurf.appcompletely rather than closing windows. - Inspect
~/.codeium/windsurf/mcp_config.jsonto review configured MCP servers and verify no Windsurf helpers remain.
Check for running processes in Terminal (read-only):
ps -eo pid,ppid,comm,args | grep -i "Windsurf.app" | grep -v grep
Check config / MCP entries:
ls -la "$HOME/.codeium/windsurf/mcp_config.json" 2>/dev/null
Why manual quitting misses edge cases: Like Cursor, Windsurf spawns multiple helper processes and MCP children that keep using RAM and network connections if the app is merely hidden or its windows closed.
What happens when you pause Windsurf with AI Stopper
- Stops
Windsurf.appand its child process tree using exact bundle path matching. - Snapshots
~/.codeium/windsurf/mcp_config.jsonlocally while paused and restores it intact on resume. - Works alongside Cursor, Claude Code, Codex, and OpenCode when switching into NDA or focus sessions.