windsurf-advanced-troubleshooting

Featured

Advanced Windsurf debugging for hard-to-diagnose IDE, Cascade, and indexing issues. Use when standard troubleshooting fails, Cascade produces consistently wrong output, or investigating deep configuration problems. Trigger with phrases like "windsurf deep debug", "windsurf mystery error", "windsurf impossible to fix", "cascade keeps failing", "windsurf advanced debug".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Windsurf Advanced Troubleshooting ## Overview Deep debugging techniques for Windsurf issues that resist standard troubleshooting. Covers Cascade context corruption, indexing engine problems, extension conflicts, MCP failures, and workspace configuration debugging. ## Prerequisites - Standard troubleshooting attempted (see `windsurf-common-errors`) - Terminal access - Understanding of Windsurf's architecture (VS Code base + Codeium AI layer) ## Instructions ### Step 1: Isolate Windsurf Layer vs VS Code Layer ``` Windsurf = VS Code + Codeium AI Layer If the issue is: - Editor crashes, rendering, file system → VS Code layer - AI suggestions wrong, Cascade fails, indexing stuck → Codeium layer - Extension not working → Extension compatibility layer Test VS Code layer: windsurf --disable-extensions # Run without extensions # If issue persists → VS Code layer problem Test Codeium layer: # Disable Codeium: Extensions > search "codeium" > Disable # If issue resolves → Codeium layer problem ``` ### Step 2: Debug Cascade Context Issues When Cascade consistently gives wrong or irrelevant suggestions: ```bash set -euo pipefail echo "=== Cascade Context Debug ===" # 1. Check rules file echo "--- .windsurfrules ---" if [ -f .windsurfrules ]; then CHARS=$(wc -c < .windsurfrules) echo "Size: $CHARS chars (limit: 6000)" [ "$CHARS" -gt 6000 ] && echo "WARNING: Over limit — content truncated!" else echo "MISSING — Cascade has no project context" fi # 2. Check wor...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category