Windsurf

Works with the CLI alone. No gander.md account.

Windsurf is Codeium's AI IDE. Cascade is the agent that can mention skills and edit across the project.

Windsurf Cascade loads Agent Skills from .windsurf/skills in a project and ~/.codeium/windsurf/skills for the user. You can @mention a skill in Cascade. gander skill does not write the Windsurf dest. Add a symlink after install.

1. Install the CLI

curl -fsSL https://release.gander.md/install.sh | bash
gander --version

After Homebrew or a source build, run gander skill.

mkdir -p ~/.codeium/windsurf/skills
ln -sfn ~/.gander/skill ~/.codeium/windsurf/skills/gander
ls -l ~/.codeium/windsurf/skills/gander/SKILL.md

Project dest:

mkdir -p .windsurf/skills
ln -sfn ~/.gander/skill .windsurf/skills/gander

Reload Windsurf. In Cascade, @gander or ask it to gander a markdown file.

3. Sign up and add MCP

gander signup --email [email protected]

Windsurf MCP config is typically ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gander": {
      "command": "gander",
      "args": ["mcp"]
    }
  }
}

Restart Windsurf. Use a full path if Cascade cannot find gander.

4. Use it

  1. Ask Cascade for a plan as markdown, then gander this file.
  2. gander watch plan.md after signup.
  3. Send the hosted URL. Reviewers stay in the browser.
  4. @agent comments come through MCP. Cascade edits the local file.

Fallback: gander comments.

5. Verify

gander list
gander comments
ls ~/.codeium/windsurf/skills/gander

More: Skill, MCP, Hosted watch.