code-index

What problem does it solve?

Navigating large codebases with traditional tools like grep is slow and inefficient, making it difficult for developers to quickly find relevant code, understand dependencies, or assess complexity. This skill builds and queries a hierarchical code index, enabling sub-second code discovery and impact analysis.

Core Features & Use Cases

• Hierarchical Indexing: Organizes Python code into Functional Categories, Components, and specific Implementations (file:line_start:line_end).
• Sub-second Queries: Search by category, component, or regex pattern for instant code discovery.
• Incremental Updates: Automatically re-indexes only changed files after commits, keeping the index fresh without full rebuild costs.
• Dependency Analysis: Maps import and function call relationships for impact analysis and safe refactoring.
• Complexity Scoring: Calculates cyclomatic complexity and lines of code for each component.
• Use Case: A new developer needs to understand the codebase structure. They use this skill to browse the entire codebase as an ASCII tree, explore specific API categories, and instantly find all related code, accelerating their ramp-up time by 2-3x.

Quick Start

# Build the initial index (full rebuild)
python scripts/build_index.py

# Search for all authentication-related code
python scripts/query_index.py --search "authentication"

# Find files that import a specific module for impact analysis
python scripts/query_index.py --deps "coffee_maker/auth/jwt.py"