Diagnose and fix Windsurf common errors and exceptions. Use when encountering Windsurf errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "windsurf error", "fix windsurf", "windsurf not working", "debug windsurf".
npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill windsurf-common-errorsLoading…
Quick reference for the most common Windsurf IDE errors and their solutions. Covers Cascade failures, Supercomplete issues, indexing problems, and extension conflicts.
Symptoms: Cascade panel shows spinner indefinitely, no response to prompts.
Solutions:
Symptoms: No ghost text appears while typing.
Solutions:
.codeiumignore: Current file might be excluded from indexing// Verify in settings.json
{
"editor.inlineSuggest.enabled": true,
"codeium.autocomplete.enable": true
}
Symptoms: Status bar shows "Indexing..." for extended periods, Cascade lacks context.
Solutions:
.codeiumignore:node_modules/
.git/
dist/
build/
.next/
coverage/
vendor/
__pycache__/
*.min.js
*.bundle.js
*.map
Symptoms: Duplicate suggestions, slow editor, features not working.
Known conflicts:
GitHub Copilot — conflicts with Supercomplete (disable one)
TabNine — conflicts with Supercomplete
Cody (Sourcegraph) — conflicts with Cascade
IntelliCode — may interfere with completions
Fix: Disable conflicting extensions:
Extensions sidebar > Search "copilot" > Disable
Symptoms: Cascade modifies files you didn't intend.
Solutions:
.windsurfignore to protect sensitive directoriesSymptoms: "You've used all your credits" or specific model unavailable.
Solutions:
Symptoms: MCP tools not appearing in Cascade, "server disconnected" errors.
Solutions:
~/.codeium/windsurf/mcp_config.json${VAR} interpolationSymptoms: Cascade forgets what it was doing, makes contradictory changes.
Solutions:
@src/services/auth.ts| Issue | Quick Fix | Root Cause |
|---|---|---|
| No AI features | Check auth in status bar | Token expired, re-sign-in |
| Cascade slow | Add .codeiumignore | Indexing too many files |
| Wrong suggestions | Update .windsurfrules | Missing project context |
| Preview broken | Close and re-open Preview | Dev server disconnected |
| Terminal errors | Cmd/Ctrl+Shift+. | Auto-debug via Cascade |
# Check if Windsurf is installed
windsurf --version
# Check Codeium auth state
ls ~/.codeium/
Command Palette (Cmd/Ctrl+Shift+P):
1. "Codeium: Reset Indexing"
2. "Cascade: Restart"
3. "Developer: Reload Window"
For comprehensive debugging, see windsurf-debug-bundle.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).