🌊
MCP + .windsurfrules

Windsurf + MindMeld

Governed standards in every Cascade session via MCP bridge or static rules file.

1 Install the CLI

Install the MindMeld CLI globally via npm.

npm install -g @equilateral_ai/mindmeld

2 Create an API Token

Generate a token from the MindMeld dashboard. This authenticates the MCP bridge with your team's standards corpus.

# Go to your dashboard and create a token
open https://app.mindmeld.dev/api-tokens
Tip: Each team member should create their own token. Tokens are scoped to your organization and can be revoked at any time.

3 Configure Windsurf MCP

Add the MindMeld MCP server to your Windsurf configuration.

# Edit your Windsurf MCP config
open ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "mindmeld": { "command": "mindmeld", "args": ["mcp"], "env": { "MINDMELD_TOKEN": "mm_live_your_token_here" } } } }

4 Restart Windsurf

Restart Windsurf to pick up the new MCP configuration. Once restarted, verify that MindMeld tools appear in Windsurf's tool list.

Verify: Open a new Cascade session and confirm you see the MindMeld tools available. If they don't appear, check that the CLI is installed globally and your token is valid.

5 Use at Task Start

Begin each Cascade session by calling mindmeld_init_session. This loads context-relevant standards for the files and patterns you're working with.

# At the start of any task, call:
mindmeld_init_session
How it works: The MCP bridge analyzes your current context (open files, recent changes, project structure) and injects the most relevant standards from your team's corpus. Standards update in real time as your corpus evolves.

1 Install the CLI

Install the MindMeld CLI globally via npm.

npm install -g @equilateral_ai/mindmeld

2 Log In

Authenticate with your MindMeld account to access your team's standards corpus.

mindmeld login

3 Generate .windsurfrules

Export your standards as a static .windsurfrules file that Windsurf reads automatically.

mindmeld inject --format windsurfrules

This creates a .windsurfrules file in your project root containing your team's current standards, patterns, and anti-patterns formatted for Windsurf's Cascade engine.

4 Keep It Updated

The .windsurfrules file is a static snapshot. Re-run the inject command whenever your standards change.

# Re-generate after standards updates
mindmeld inject --format windsurfrules
Note: The .windsurfrules file is a point-in-time export. It does not auto-update when your team's standards evolve. For always-current standards, use the MCP Bridge method instead.

Switching Accounts

MCP Bridge method: Generate a new API token from the other account's dashboard at app.mindmeld.dev/api-tokens, update the token in ~/.codeium/windsurf/mcp_config.json, and restart Windsurf.

.windsurfrules method: Switch CLI accounts with mindmeld logout then mindmeld login, then re-run mindmeld inject --format windsurfrules to regenerate the file.

Use mindmeld status to check which CLI account is currently active.

Setup Guides for Other Tools

Claude Code Cline Cursor Multi-Tool Teams