Documentation

Get Started

Windsurf

Connect Bardo through Windsurf Cascade MCP settings and keep play anchored in the local workspace.

Use this guide for Windsurf and Cascade MCP.

Install WindsurfLink to install-windsurf

Install or update Windsurf, then open the campaign workspace you want Bardo to manage.

Windsurf's current MCP docs describe adding servers from Settings → Tools → Windsurf Settings → Add Server, and note that custom server config uses MCP JSON.

Connect BardoLink to connect-bardo

From the workspace root:

bardo login
bardo init
bardo connect --client windsurf

Expected result: Bardo writes .windsurf/mcp.json in the workspace root.

What Bardo writesLink to what-bardo-writes

Bardo writes a workspace MCP config that starts the local Bardo bridge with bardo mcp serve. Keep this config in the project that owns the .bardo/ prep layer.

Use Bardo well in WindsurfLink to use-bardo-well-in-windsurf

Open Windsurf from the same workspace where you ran bardo connect --client windsurf.

Troubleshooting:

  • Restart Windsurf after connecting if Cascade does not see Bardo yet.
  • If Windsurf shows Bardo but no useful output, check workspace readiness before asking it to continue play.
  • If .bardo/ is missing, re-run bardo init before resuming.