How do I fix the '@codebase' search not working?

This skill provides instructions to refresh the index via the Command Palette or manually clear the index cache to restore AI search functionality.

What should I do if my index still won't update?

The skill guides you through a multi-step recovery process including cache clearing, status bar checks, and IDE restarts to resolve persistent indexing failures.

Why is my Cursor codebase index stuck?

Indexing often stalls due to massive unignored directories like node_modules or build artifacts; this skill helps you properly configure .cursorignore to bypass these folders.

Can I speed up the indexing process in Cursor?

Yes, by narrowing the scope of the index through optimized exclusion patterns and ensuring system file watcher limits are correctly set, you can significantly improve indexing speed.

Cursor Indexing Troubleshooter

Name: Cursor Indexing Troubleshooter
Author: jeremylongshore

byjeremylongshore

•

1,031

Developer Tools

Resolves Cursor IDE codebase indexing problems to ensure accurate AI search results and optimal performance.

About

This skill provides specialized guidance for diagnosing and fixing indexing issues within the Cursor IDE, ensuring that AI-powered features like @codebase function correctly. It assists developers when the indexer gets stuck, search results appear empty, or performance lags on large repositories. By providing actionable steps to optimize .cursorignore files, clear local caches, and manage OS-level file watcher limits, this skill restores the critical link between your codebase and Claude's context-aware capabilities.

Key Features

Provides terminal commands for clearing persistent index caches
1,031 GitHub stars
Optimizes .cursorignore configurations to improve speed
Resolves empty or inaccurate @codebase search results
Diagnoses OS-level file watcher limitations and ENOSPC errors
Fixes stuck or hanging codebase indexing progress

Use Cases

Forcing a clean re-index of a repository after significant structural changes
Troubleshooting when Cursor fails to find existing files via AI features
Improving IDE performance by excluding large, unnecessary folders from the index

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jeremylongshore/claude-code-plugins-plus-skills cursor-indexing-issues

For use in Claude.ai and ChatGPT

Download Skill

GitHub