About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/windsurf-pack/skills/windsurf-common-errors/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-common-errors. Copyright stays with the author (MIT).

Windsurf Common Errors

Name: windsurf-common-errors
Author: jeremylongshore

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

// 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:

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
Command Palette > "Codeium: Reset Indexing"

Error 4: Extension Conflicts

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

Error 5: Cascade Writes to Wrong Files

Symptoms: Cascade modifies files you didn't intend.

Solutions:

Be specific in prompts: name exact file paths
Add constraints: "Don't modify any files except src/services/auth.ts"
Use .windsurfignore to protect sensitive directories
Review diffs before accepting -- use the Revert button per step
Always commit before Cascade sessions for safe rollback

Error 6: "Model not available" or Credit Exhausted

Symptoms: "You've used all your credits" or specific model unavailable.

Solutions:

Free plan: 25 credits/month. Switch to SWE-1 Lite (unlimited)
Pro plan: 500 credits/month. Buy additional credits at windsurf.com/account
Switch model: Use the model dropdown in Cascade to select a different model
Check credit usage: Windsurf widget > Account > Usage

Error 7: MCP Server Not Connecting

Symptoms: MCP tools not appearing in Cascade, "server disconnected" errors.

Solutions:

Verify MCP is enabled: Settings > Cascade > MCP > Enable
Check config file: ~/.codeium/windsurf/mcp_config.json
Verify command exists: Run the MCP command manually in terminal
Check environment variables: MCP config supports ${VAR} interpolation
Restart: Command Palette > "Cascade: Restart MCP Servers"

Error 8: Cascade Loses Context Mid-Conversation

Symptoms: Cascade forgets what it was doing, makes contradictory changes.

Solutions:

Keep conversations focused: one task per Cascade session
Start a new conversation for new tasks (Cmd/Ctrl+L, then + icon)
Use @ mentions to re-inject context: @src/services/auth.ts
Convert key decisions to Memories: "Remember that we're using JWT, not sessions"
For long tasks, use Workflows instead of multi-turn conversations

Error Handling

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

Examples

Quick Health Check

# Check if Windsurf is installed
windsurf --version

# Check Codeium auth state
ls ~/.codeium/

Reset Everything

Command Palette (Cmd/Ctrl+Shift+P):
1. "Codeium: Reset Indexing"
2. "Cascade: Restart"
3. "Developer: Reload Window"

Resources

Next Steps

For comprehensive debugging, see windsurf-debug-bundle.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-comm-8265db/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-windsurf-comm-8265db.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-windsurf-comm-8265db",
  "kind": "skill",
  "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\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "customer_support"
    ],
    "tags": [
      "skill-md",
      "saas",
      "windsurf",
      "debugging",
      "troubleshooting",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/saas-packs/windsurf-pack/skills/windsurf-common-errors/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/windsurf-pack/skills/windsurf-common-errors/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/windsurf-pack/skills/windsurf-common-errors/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Grep,",
      "Bash(curl:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Windsurf Common Errors\n\n## Overview\n\nQuick reference for the most common Windsurf IDE errors and their solutions. Covers Cascade failures, Supercomplete issues, indexing problems, and extension conflicts.\n\n## Prerequisites\n\n- Windsurf installed and previously working\n- Access to Windsurf settings and logs\n\n## Instructions\n\n### Error 1: Cascade Not Responding\n\n**Symptoms:** Cascade panel shows spinner indefinitely, no response to prompts.\n\n**Solutions:**\n\n1. Check internet connection -- Cascade requires cloud access\n2. Check Windsurf status: https://status.windsurf.com\n3. Check credit balance",
  "cost": {
    "context_tokens": 1252
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-comm-8265db/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.