GenZAgents for Windsurf — Codeium's IDE meets cryptographic receipts

Windsurf is built on top of VS Code but ships the Cascade agent natively. Like Cursor, the leverage per session is enormous; like Cursor, the accountability gap is similarly large. Drop GenZAgents in via the MCP config, and every Cascade run starts producing receipts tagged with the project, the model, the engineer, and the runtime cost in USD. The integration takes 90 seconds end-to-end.

Cascade's most distinctive feature is its multi-step plan view. GenZAgents captures each plan as a parent receipt; each step's tool calls become children with parent_run_id pointing back. This lets you see "Cascade planned 14 steps, executed 12, the engineer interrupted the last 2" on the receipt feed. That granularity is what your compliance team wants when reviewing AI-assisted work after the fact.

A common pattern: an engineer uses Cursor on Mac and Windsurf on Linux for the same project. GenZAgents stitches them together — both IDEs feed into the same agent DID, the receipt feed shows the work as one continuous timeline, the cost reports roll up correctly. The IDE name shows up as runtimeProvider on the receipt, so you can filter "show me everything from Windsurf last week" if needed.

Codeium has serious enterprise customers (defence, finance, healthcare). Those orgs already have NDA-locked compliance requirements around AI-generated work. GenZAgents drops in as the receipt layer above Cascade — no integration with Codeium's servers required, no exfiltration concern, everything is between your local Windsurf instance and api.genzagents.com.

The org_context_lookup tool works the same as in Cursor / Claude Code: at the start of a Cascade session, if Cascade calls org_context_lookup, we query the org's receipts and return matches. "Sarah did this on May 10th in Cursor — see receipt rcpt_…" — so a Windsurf engineer benefits from the org's past work regardless of which IDE that work happened in.

Same path as the other IDEs: @genzagentsio/setup via MDM with the org install token. The setup CLI detects Windsurf alongside Cursor, Cline, Claude Code, and writes the right MCP config for each.

Windsurf → Settings → MCP Servers → Configure MCP servers → add:

{
  "mcpServers": {
    "genzagents": {
      "command": "npx",
      "args": ["-y", "@genzagentsio/mcp-server"]
    }
  }
}

Restart Cascade for the integration to register.

Cascade agent runs, Cmd-I sessions, inline edits that invoke MCP tools.

Open Windsurf → Cascade → ask Cascade to use the GenZAgents tool to draft a receipt → confirm the draft on /dashboard.