| name | windsurf-performance-tuning |
| description | Optimize Windsurf IDE performance: indexing speed, Cascade responsiveness, and memory usage.
Use when Windsurf is slow, indexing takes too long, Cascade times out,
or the IDE uses too much memory.
Trigger with phrases like "windsurf slow", "windsurf performance",
"optimize windsurf", "windsurf memory", "cascade slow", "indexing slow".
|
| allowed-tools | Read, Write, Edit, Grep |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","windsurf","performance","indexing","optimization"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Windsurf Performance Tuning
Overview
Optimize Windsurf's indexing engine, Cascade context building, Supercomplete latency, and overall IDE responsiveness. Most performance issues stem from indexing too many files or missing exclusion patterns.
Prerequisites
- Windsurf IDE installed
- Understanding of workspace indexing
- Access to Windsurf settings
Instructions
Step 1: Optimize Workspace Indexing
The indexing engine is the #1 performance factor. Exclude everything that isn't source code:
# .codeiumignore — aggressive exclusion for large codebases
# Build artifacts
node_modules/
dist/
build/
.next/
.nuxt/
.output/
.svelte-kit/
coverage/
.cache/
# Package manager
pnpm-lock.yaml
package-lock.json
yarn.lock
# Generated code
*.min.js
*.min.css
*.bundle.js
*.chunk.js
**/*.map
generated/
__generated__/
# Binary and media files
*.png
*.jpg
*.gif
*.svg
*.ico
*.mp4
*.woff
*.woff2
*.ttf
*.eot
# Data files
*.sqlite
*.db
*.sql.gz
*.csv
# Python
__pycache__/
*.pyc
.venv/
venv/
.tox/
*.egg-info/
# Go
vendor/
# Rust
target/
Step 2: Open Focused Workspaces
# DON'T: Open entire monorepo root
windsurf ~/monorepo/ # Indexes ALL packages = slow
# DO: Open specific service directories
windsurf ~/monorepo/apps/web/ # Only indexes web app
windsurf ~/monorepo/packages/api/ # Only indexes API
# Each Windsurf window gets its own focused AI context
# Cascade performs better with fewer, relevant files
Step 3: Tune IDE Settings
{
"codeium.indexing.maxFileSize": 524288,
"extensions.autoUpdate": false,
"extensions.autoCheckUpdates": false,
"editor.minimap.enabled":
