llmgrep 3.8.2

Smart grep over Magellan code maps with schema-aligned JSON output
Documentation

llmgrep

Crates.io Documentation

Version: 3.8.2

Pattern-based code search for Magellan databases. Fast, deterministic symbol search with JSON output.

Positioning: Read-only query tool for codebases indexed by Magellan. Use to find symbols, references, call relationships, source documents, and knowledge triples. Emits structured JSON for code analysis.

Purpose

llmgrep queries Magellan databases. Built for:

  • Code Analysis — Structured JSON output for programmatic analysis
  • Developers — Fast symbol search without IDE overhead
  • Tooling — Scriptable code analysis with precise byte spans

Features

  • Symbol search — Find functions, structs, traits by name or regex
  • Semantic search — Natural-language code search via HNSW vector similarity (requires Magellan embeddings)
  • Reference lookup — Find all callers/callees of a function
  • Call graph traversal — Navigate caller → callee relationships
  • Graph navigation — Stepable depth-aware traversal via navigate command
  • Source document search — Query wiki pages, specs, messages by tags and wikilinks
  • Knowledge triple search — Query candidate facts by subject, predicate, object
  • AST filtering — Filter by node kind, nesting depth, complexity
  • Path normalization — Consistent path handling across platforms
  • Explicit ambiguity handling — Structured results for disambiguation
  • Parameterized SQL — All database queries use bound parameters (no string interpolation)

Quick Start

# Install
cargo install llmgrep

# Create SQLite database
magellan watch --root ./src --db code.db

# Search symbols
llmgrep --db code.db search --query "parse"

# Find references
llmgrep --db code.db search --query "MyType" --mode references

# Semantic search (requires `magellan embed` first)
llmgrep --db code.db search --query "parse command line arguments" --mode semantic

Installation

# Install with default features
cargo install llmgrep

cargo install llmgrep

Backends

Backend File Features Status
SQLite .db Full search Default (always available)

Backend detection is automatic for supported SQLite databases.

Requirements

  • Magellan with SQLite .db output — schema v18 supported
  • sqlitegraph 3.0+ — Included automatically

Documentation

What llmgrep Does NOT Do

  • ❌ Index code (use Magellan)
  • ❌ Generate embeddings (use magellan embed --db <db>)
  • ❌ Type checking or semantic analysis
  • ❌ Background file watching
  • ❌ Code editing (use splice)
  • ❌ CFG analysis (use Mirage)

License

GPL-3.0-only. See LICENSE.