Skip to main content

Windsurf Integration

Windsurf is Codeium's AI-powered IDE. Erold integrates via MCP for seamless task management.

Setup

1. Get Your API Key

Create an API key in Erold under Settings → API Keys.

2. Configure Windsurf

Edit the Windsurf configuration:

// ~/.windsurf/config.json

{
  "mcpServers": {
    "yet": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here"
      }
    }
  }
}

3. Restart Windsurf

Restart Windsurf to load the MCP configuration.

4. Verify

Ask the AI: "Show my Erold tasks"

Cascade Integration

Windsurf's Cascade feature works seamlessly with Erold. The AI can:

  • Read task requirements before suggesting code
  • Update task status as you complete work
  • Reference knowledge base for coding standards
  • Create new tasks when it identifies issues

Example: Guided Development

You: "Help me implement MYAPP-45"

Cascade: [Reads task details from Erold]

"MYAPP-45 is about fixing database timeouts. Based on your
knowledge base, you're using PostgreSQL with a pool size of 10.

I'll help you:
1. Increase the connection pool
2. Add timeout handling
3. Implement retry logic

Let me start with the connection pool configuration..."

Using Flows with Erold

Windsurf Flows can incorporate Erold context: 

You: "Start a flow for implementing user authentication"

Cascade: [Creates flow, checks Erold for related tasks]

"I found these related tasks:
- MYAPP-47: Implement JWT auth
- MYAPP-48: Add password reset

I'll create a flow that addresses both. Let me also check
your knowledge base for auth requirements...

Found: 'Auth must support OAuth2 and email/password'

Starting implementation flow..."

Workspace Configuration

For multi-project setups, use workspace-specific config: 

// .windsurf/config.json in project root

{
  "mcpServers": {
    "yet": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here",
        "EROLD_DEFAULT_PROJECT": "MYAPP"
      }
    }
  }
}

Tips

Let Cascade Read Tasks First

Before implementing, ask Cascade to understand the task:

"Read MYAPP-45 and tell me what needs to be done"

Update Status During Work

"Mark MYAPP-45 as in progress, I'm starting on it"

Use Knowledge Base

"Check the knowledge base for our error handling patterns"

Troubleshooting

MCP not recognized

  • Verify config file location: ~/.windsurf/config.json
  • Check JSON syntax
  • Ensure Node.js 18+ is installed

Connection issues

  • Test API key with CLI: erold whoami
  • Check firewall settings

Next Steps