← All 33 supported Mac AI tools

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.

Coding IDE · macOS App · Verified 2026-11-19 · macOS 13+ (Apple silicon)

What AI Stopper detects for Windsurf

  • macOS app bundle: Windsurf.app in /Applications or ~/Applications and all child helpers
  • Snapshotted MCP config: ~/.codeium/windsurf/mcp_config.json

How to stop Windsurf manually on macOS

  1. Save open files and let any active Cascade edits complete before interrupting.
  2. Press Command + Q to quit Windsurf.app completely rather than closing windows.
  3. Inspect ~/.codeium/windsurf/mcp_config.json to 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.app and its child process tree using exact bundle path matching.
  • Snapshots ~/.codeium/windsurf/mcp_config.json locally while paused and restores it intact on resume.
  • Works alongside Cursor, Claude Code, Codex, and OpenCode when switching into NDA or focus sessions.

Related guides & workflows