cursor-indexing-issues
Installation
SKILL.md
Cursor Indexing Issues
Diagnose and fix codebase indexing problems. Covers stuck indexing, empty search results, stale results, and performance optimization for large codebases.
Quick Diagnosis
| Symptom | Likely Cause | Quick Fix |
|---|---|---|
| Status bar stuck on "Indexing..." | Large codebase or network issue | Add .cursorignore, resync |
| @Codebase returns nothing | Index not built or file excluded | Wait for index, check ignore files |
| @Codebase finds wrong code | Stale index | Resync index |
| Indexing crashes / restarts | Memory or file watcher limits | Increase limits, reduce scope |
| "Unable to index" error | Network blocked or auth expired | Check proxy/firewall, re-auth |
Fix: Stuck Indexing
Step 1: Reduce Scope
Create or update .cursorignore in project root: