cursor-indexing-issues
Troubleshoot Cursor codebase indexing problems. Triggers on "cursor indexing","cursor index", "cursor codebase", "@codebase not working", "cursor search broken".
When & Why to Use This Skill
The Cursor Indexing Issues skill is a specialized diagnostic tool designed to troubleshoot and resolve codebase indexing problems within the Cursor IDE. It provides developers with actionable solutions for stuck indexing, empty search results, and performance bottlenecks, ensuring that AI-powered features like @codebase and semantic search function at peak efficiency.
Use Cases
- 1. Resolving Stuck Indexing: Provides step-by-step guidance to identify and fix instances where the Cursor indexer hangs or fails to complete, restoring full AI context awareness.
- 2. Optimizing Search Accuracy: Helps users configure .cursorignore files and manage index caches to eliminate empty search results and ensure the AI correctly parses the entire project.
- 3. Performance Tuning: Offers solutions for large workspace performance issues, including file watcher configuration and manual refresh procedures to maintain a responsive coding environment.
| name | "cursor-indexing-issues" |
|---|---|
| description | | |
| allowed-tools | "Read, Write, Edit, Bash(cmd:*)" |
| version | 1.0.0 |
| license | MIT |
| author | "Jeremy Longshore <jeremy@intentsolutions.io>" |
Cursor Indexing Issues
Overview
This skill helps troubleshoot Cursor codebase indexing problems. It provides solutions for stuck indexing, empty search results, performance issues, and configuration optimization to ensure your codebase is properly indexed for AI features.
Prerequisites
- Cursor IDE with indexing enabled
- Access to Cursor settings
- Command line access for cache clearing
- Understanding of project file structure
Instructions
- Check indexing status in status bar
- Identify the specific issue (stuck, empty results, performance)
- Review and update
.cursorignoreconfiguration - Try manual refresh via Command Palette
- Clear index cache if issues persist
- Restart Cursor and allow re-indexing
Output
- Functional codebase indexing
- Working
@codebasesearch queries - Optimized indexing performance
- Properly configured exclusion patterns
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.