windsurf-common-errors
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". '
Profile →npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill windsurf-common-errors --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 {
- Overview
- Prerequisites
- Instructions
- Error 1: Cascade Not Responding
- Error 2: Supercomplete Not Showing Suggestions
- Error 3: Indexing Stuck or Slow
- Error 4: Extension Conflicts
- Error 5: Cascade Writes to Wrong Files
- Error 6: "Model not available" or Credit Exhausted
- Error 7: MCP Server Not Connecting
- Error 8: Cascade Loses Context Mid-Conversation
- Error Handling
- Examples
- Quick Health Check
Check if Windsurf is installed windsurf --version Check Codeium auth state ls ~/.codeium/
What does the windsurf-common-errors skill do?
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". '
How do I install it?
Run `npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill windsurf-common-errors --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jeremylongshore/claude-code-plugins-plus-skills, a repository with 2,630 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.