Skip to content

Codeium · .windsurfrules

Best Windsurfrules & configs — RuleSell

Windsurf is Codeium's AI-first IDE with Cascade — a multi-step agent that plans, edits, and runs commands. Modern Windsurf reads rules from .windsurf/rules/*.md (workspace-scoped, multi-file). The legacy single-file .windsurfrules format still works. Hard limits: 12,000 chars per workspace rule, 6,000 per global rule.

Top 5 Windsurf rules right now

Ranked by quality score — freshness, schema completeness, and review signals. Refreshed daily.

No Windsurflistings yet during beta — but they're landing fast. Be the first to publish for Windsurf:

Why use Windsurf rules from RuleSell

  • Quality-scored .windsurfrules files for popular stacks.
  • Same rule often works in Cursor too — many listings ship dual-format.
  • Real GitHub author attribution, SPDX license, automated freshness signal.
  • Copy-paste install at the repo root — no setup beyond cloning.

How to use Windsurf rules

  1. 1. Pick a Windsurf rule

    Browse the listings below and open one that matches your stack.

  2. 2. Copy the file contents

    Click "Copy" on the listing — or download the raw file from the source URL.

  3. 3. Paste into .windsurf/rules/*.md (modern) or .windsurfrules (legacy)

    Drop the rule into .windsurf/rules/*.md (modern) or .windsurfrules (legacy). The exact command: # Modern (recommended):

  4. 4. Restart Windsurf

    Restart your Windsurf session so the new rule is loaded. Verify it appears in the active context.

# Modern (recommended):
mkdir -p .windsurf/rules
cp rule.md .windsurf/rules/my-rule.md
# Legacy single-file:
cp rule.windsurfrules ./.windsurfrules

Windsurf rules — frequently asked

Where do Windsurf rules live?

Windsurf reads .windsurfrules from the repo root. Global memories live in your Windsurf settings and persist across projects.

Can a Cursor rule be used in Windsurf?

Often yes — both tools read plain-markdown rules and follow similar conventions. Many .cursorrules files work as-is when renamed to .windsurfrules. RuleSell lists rules dual-tagged when they're compatible.

Does Windsurf support MCP servers?

Yes. MCP servers configured for Claude Code generally work with Windsurf via Cascade's MCP support — check the server's transport (stdio vs SSE) and environment variables.

How do I share Windsurf rules with my team?

Commit .windsurfrules to git. Every teammate using Windsurf on that repo gets the same context.

Are Windsurf rules quality-scored?

Yes — RuleSell scores every listing (including Windsurf rules) from freshness, schema completeness, and review signals. No star-rating gaming.

More on RuleSell