Windsurf by Codeium

Set up Windsurf for your project

Windsurf by Codeium is an AI-powered code editor that uses project rules and MCP servers to understand your codebase. Without proper configuration, Windsurf's Cascade agent falls back to generic suggestions that don't match your team's conventions. Caliber generates Windsurf-compatible configs automatically by scanning your codebase.

What Windsurf needs to work well

Windsurf reads two types of configuration to deliver better AI assistance:

• Project rules — rules files in your project that tell Windsurf your coding conventions, architecture patterns, naming standards, and preferred libraries. These guide Cascade to generate code that fits your codebase
• MCP server configs — MCP (Model Context Protocol) servers that extend Windsurf with external tools like database access, API documentation, and deployment capabilities. See the MCP setup guide

What Caliber generates for Windsurf

Caliber analyzes your actual codebase — your file structure, dependencies, naming conventions, test patterns, and import style — and generates configuration that Windsurf understands:

• Rules files — comprehensive project rules covering your conventions, patterns, error handling, and what to avoid
• MCP configs — recommended MCP servers for your tech stack, written in Windsurf's expected format
• Project context — framework detection, dependency analysis, and architecture patterns that help Cascade understand your project at a deeper level

Set up Windsurf with Caliber

1. 1Navigate to your project — open a terminal in your project root directory
2. 2Run bootstrap — run npx @rely-ai/caliber bootstrap. Caliber detects your framework, language, testing setup, and code patterns
3. 3Review output — Caliber generates Windsurf-compatible rules files with project-specific conventions and MCP server configurations for your stack
4. 4Keep it fresh — run npx @rely-ai/caliber bootstrap again as your project evolves to regenerate configs

Works with all your AI tools

Caliber generates configs for every major AI coding tool from the same scan — not just Windsurf. One command sets up your entire AI toolkit:

• Claude Code — generates CLAUDE.md and MCP configs
• Cursor — generates .cursorrules and .cursor/mcp.json
• All AI tools at once — configure your full AI coding setup in one command

Frequently asked questions