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".
Quick reference for the top 10 most common Windsurf errors and their solutions.
Check error message and code in your logs or console.
Match your error to one of the documented cases.
Follow the solution steps for your specific error.
**Error Message:**
```
Authentication error: Invalid API key
```
**Cause:** API key is missing, expired, or invalid.
**Solution:**
```bash
echo $WINDSURF_API_KEY
```
---
**Error Message:**
```
Rate limit exceeded. Please retry after X seconds.
```
**Cause:** Too many requests in a short period.
**Solution:**
Implement exponential backoff. See `windsurf-rate-limits` skill.
---
**Error Message:**
```
Request timeout after 30000ms
```
**Cause:** Network connectivity or server latency issues.
**Solution:**
```typescript
// Increase timeout
const client = new Client({ timeout: 60000 });
```
```bash
curl -s https://status.windsurf.com
curl -I https://api.windsurf.com
env | grep WINDSURF
```
1. Collect evidence with `windsurf-debug-bundle`
2. Check Windsurf status page
3. Contact support with request ID
For comprehensive debugging, see `windsurf-debug-bundle`.
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/windsurf-common-errors/raw