Cursor Codebase Indexing

Provides setup and optimization of Cursor's codebase indexing for semantic code search and improved AI context awareness.

Overview

What is Codebase Indexing?

Codebase indexing creates a searchable representation of your code:

• Enables @codebase queries
• Powers semantic code search
• Improves AI context awareness
• Helps AI understand project structure

Prerequisites

• Cursor IDE installed and authenticated

• Project workspace with source files

• Sufficient disk space for index storage

• Stable network connection for initial setup

Instructions

• Open your project in Cursor

• Navigate to Settings > Cursor > Codebase Indexing

• Enable "Index this workspace"

• Create .cursorignore file at project root

• Add exclusion patterns for large/irrelevant directories

• Wait for indexing to complete (check status bar)

• Test with @codebase queries in chat

Output

• Indexed codebase enabling @codebase queries

• Semantic code search functionality

• Improved AI context awareness

• Searchable symbol table and definitions

Error Handling

See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for detailed examples.

Resources

• Cursor Indexing Documentation

• gitignore Pattern Syntax

• Cursor Performance Guide