Windsurf setup

Windsurf uses a shared MCP config instead of the project-local setup Cursor supports. Install that once, then use the normal Switchman workspace flow in your repo.

1. Install Switchman into Windsurf once

switchman mcp install --windsurf

This writes or updates:

~/.codeium/mcp_config.json

Existing MCP servers are preserved and the switchman-mcp entry is added or refreshed.

If you want to verify the generated config:

switchman mcp install --windsurf --json

2. Prepare the repo

The fastest path is the current guided flow:

cd my-project
switchman quickcheck
switchman start "Implement auth helper"

If you want the manual flow instead:

switchman setup --agents 5
switchman verify-setup

3. Open Windsurf

In Windsurf, check:

• Settings
• Cascade
• MCP Servers

Then open the repo or generated agent workspaces and let each agent use Switchman through MCP.

4. Check the run

switchman status
switchman status --watch
switchman gate ci