Code Indexer

Local code indexer and semantic search engine for codebases. Provides fast code search, definition finding, and codebase navigation using simple pattern matching and AST-like analysis.

Setup

No additional installation required. Uses built-in Node.js modules and shell commands (grep, find, sed).

Optional: Install ripgrep for faster searches:

macOS: brew install ripgrep
Linux: apt install ripgrep or dnf install ripgrep

Usage

Index a codebase

node /job/.pi/skills/code-indexer/index.js "/path/to/project"

Search for a symbol/function

node /job/.pi/skills/code-indexer/search.js "functionName"

Find definitions

node /job/.pi/skills/code-indexer/find-def.js "ClassName" "/path/to/project"

Find references/usages

node /job/.pi/skills/code-indexer/find-refs.js "functionName" "/path/to/project"

Analyze file imports/exports

node /job/.pi/skills/code-indexer/analyze.js "/path/to/file.js"

Get project structure

node /job/.pi/skills/code-indexer/structure.js "/path/to/project"

Output Format

Search Results

{
  "query": "functionName",
  "results": [
    {
      "file": "/path/to/project/src/utils.js",
      "line": 42,
      "type": "function",
      "context": "function functionName(param) {",
      "match": "functionName"
    }
  ],
  "total": 5,
  "took": "120ms"
}

Definition Results

{
  "symbol": "MyClass",
  "definitions": [
    {
      "file": "/path/to/project/src/models.js",
      "line": 15,
      "type": "class",
      "signature": "class MyClass {"
    }
  ]
}

Import Analysis

{
  "file": "/path/to/project/src/index.js",
  "imports": [
    { "module": "./utils", "type": "named", "names": ["helper", "format"] },
    { "module": "lodash", "type": "default", "name": "_" }
  ],
  "exports": [
    { "name": "main", "type": "named" },
    { "name": "default", "type": "default" }
  ]
}

Supported Languages

JavaScript/TypeScript: Full support (ES6+ imports/exports, classes, functions)
Python: Full support (imports, classes, functions)
Java: Full support (imports, classes, methods)
Go: Full support (imports, functions, methods)
Rust: Full support (use, fn, struct, impl)
C/C++: Basic support (#include, function declarations)
Other: Basic pattern matching for any text-based file

Common Workflows

Understand a codebase

User: How is the auth system structured?
Agent: [Uses code-indexer to find auth-related files, classes, and functions]

Find where a function is defined

User: Where is the calculateTotal function defined?
Agent: [Uses find-def.js to locate the definition]

Find all usages

User: Where is this config variable used?
Agent: [Uses find-refs.js to find all references]

Analyze a new file

User: What does this file do? src/api/users.js
Agent: [Uses analyze.js to get imports/exports and structure]

Integration with Other Skills

With memory-agent: Store findings about project architecture
With git-ops: Use after checking out new branches to understand changes
With browser-tools: Document code from web-based code viewers

Configuration

The indexer respects .gitignore by default. Set environment variable CODE_INDEXER_IGNORE_GIT=0 to disable.

Index caching: Results are cached in /tmp/code-indexer-cache/ for faster repeated searches. Clear cache with node /job/.pi/skills/code-indexer/clear-cache.js.

Limitations

No semantic understanding (pattern matching only)
Does not resolve dynamic imports or complex type inference
Large codebases may take time to index initially
Some language features may not be recognized

Tips

For faster searches: Install ripgrep - the tool automatically uses it when available
For type definitions: Use find-def.js first, then find-refs.js to get full picture
For large projects: Use --limit flag to cap results: search.js "query" --limit 20

code-indexer