windsurf-common-errors

# 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:** 1. Check internet connection -- Cascade requires cloud access 2. Check Windsurf status: https://status.windsurf.com 3. Check credit balance: Windsurf widget (status bar) > Account 4. Restart Cascade: Command Palette > "Cascade: Restart" 5. Restart Windsurf: Cmd/Ctrl+Shift+P > "Reload Window" ### Error 2: Supercomplete Not Showing Suggestions **Symptoms:** No ghost text appears while typing. **Solutions:** 1. Check if disabled: Click Windsurf widget (status bar) > verify autocomplete is ON 2. Check file type: Supercomplete may be disabled for certain languages 3. Check `.codeiumignore`: Current file might be excluded from indexing 4. Ensure not conflicting: Disable GitHub Copilot or TabNine if installed ```json // Verify in settings.json { "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:** 1. Check workspace size: Windsurf struggles with 100K+ files ...