| name | windsurf-common-errors |
| description | Diagnose and fix common Windsurf IDE and Cascade errors.
Use when Cascade stops working, Supercomplete fails, indexing hangs,
or encountering Windsurf-specific issues.
Trigger with phrases like "windsurf error", "fix windsurf",
"windsurf not working", "cascade broken", "windsurf slow".
|
| allowed-tools | Read, Grep, Bash(curl:*) |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","windsurf","debugging","troubleshooting"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Windsurf Common Errors
Overview
Quick reference for the most common Windsurf IDE errors and their solutions. Covers Cascade failures, Supercomplete issues, indexing problems, and extension conflicts.
Prerequisites
- Windsurf installed and previously working
- Access to Windsurf settings and logs
Instructions
Error 1: Cascade Not Responding
Symptoms: Cascade panel shows spinner indefinitely, no response to prompts.
Solutions:
- Check internet connection -- Cascade requires cloud access
- Check Windsurf status: https://status.windsurf.com
- Check credit balance: Windsurf widget (status bar) > Account
- Restart Cascade: Command Palette > "Cascade: Restart"
- Restart Windsurf: Cmd/Ctrl+Shift+P > "Reload Window"
Error 2: Supercomplete Not Showing Suggestions
Symptoms: No ghost text appears while typing.
Solutions:
- Check if disabled: Click Windsurf widget (status bar) > verify autocomplete is ON
- Check file type: Supercomplete may be disabled for certain languages
- Check
.codeiumignore: Current file might be excluded from indexing
- Ensure not conflicting: Disable GitHub Copilot or TabNine if installed
{
"editor.inlineSuggest.enabled": true,
"codeium.autocomplete.enable": true
}
Error 3: Indexing Stuck or Slow
Symptoms: Status bar shows "Indexing..." for extended periods, Cascade lacks context.
Solutions:
- Check workspace size: Windsurf struggles with 100K+ files without ignore rules
- Create or update
.codeiumignore:
node_modules/
.git/
dist/
build/
.next/
coverage/
vendor/
__pycache__/
*.min.js
*.bundle.js
*.map
- Open a subdirectory instead of monorepo root