Windsurf

Configure Windsurf, Codeium's AI-native IDE, to route through Revo Mail for model flexibility and unified billing.

What This Does

Windsurf is an AI-native code editor built by Codeium. It features deep AI integration including Cascade, an agent that can understand your entire codebase. By connecting Windsurf to Revo Mail, you can use any model in the Revo Mail catalog while managing costs through a single unified balance.

Setup

Step 1: Open Windsurf Settings

Launch Windsurf
Click the gear icon in the sidebar or press Cmd+, (macOS) / Ctrl+, (Windows/Linux)
Navigate to AI Providers or Cascade Settings

Step 2: Add a New Provider

Click Add Provider or + Add AI Provider
Select OpenAI Compatible from the provider list

Step 3: Configure Revo Mail

Enter the following configuration:

Field	Value
Provider Name	`Revo Mail` (or any name you prefer)
Base URL	`https://api.revomail.io/v1`
API Key	Your Revo Mail API key
Model ID	`gpt-5.4` or `gpt-5.3-codex`

Get your API key from revomail.io/keys.

Step 4: Save and Activate

Save the provider configuration
Select Revo Mail as your active provider
Choose your preferred model from the model picker

Step 5: Alternative — Settings JSON

For advanced configuration, edit the settings file directly:

Open command palette: Cmd+Shift+P
Search for Open User Settings (JSON)
Add the configuration:

{
  "windsurf.aiProvider": "openai-compatible",
  "windsurf.openaiCompatibleBaseUrl": "https://api.revomail.io/v1",
  "windsurf.openaiCompatibleApiKey": "YOUR_Revo Mail_API_KEY",
  "windsurf.openaiCompatibleModel": "gpt-5.4"
}

Recommended Models for Windsurf

Feature	Model	Why
Cascade (agent mode)	`gpt-5.4`	Best for complex multi-step tasks
Code generation	`gpt-5.3-codex`	Optimized for programming
Large codebase analysis	`gemini-3.1-pro`	Extended context window
Quick chat responses	`glm-5-turbo`	Fast and cost-effective

Troubleshooting

Provider not appearing in list

Ensure you selected OpenAI Compatible, not plain OpenAI
Save settings and restart Windsurf

Authentication errors

Verify your API key is correct at revomail.io/keys
Re-paste the key without any extra spaces or newlines

Cascade doesn't work with Revo Mail

Cascade requires models with strong agentic capabilities — use gpt-5.4 for best results
Some Cascade features may require specific model capabilities

Slow responses

Use glm-5-turbo for faster responses
Check your remaining balance at revomail.io/billing

Notes

Windsurf's UI evolves frequently — exact menu paths may differ between versions
Cascade is Windsurf's flagship feature — it works best with capable models like GPT-5.4
Token usage is logged to your Revo Mail dashboard in real-time
For tab completions, consider configuring a faster model separately if Windsurf supports it

On this page