codeindex

Temporal code knowledge graph with blast-radius impact scoring, semantic symbol search, and git-history-aware dependency analysis — for AI-assisted development.

Point it at any project — Python, JavaScript/TypeScript, Go, Ruby, Rust, Java, PHP, and more — and get:

• A persistent SQLite graph store at <repo>/.codeindex/index.db — incremental, queryable, temporal
• A codeindex.json dependency index written directly into your repo (preserved for backward compatibility)
• Per-file blast-radius scores (how many files break if this one changes), including historical as-of queries
• A symbolindex.json symbol map so AI can find any function/class without scanning every file
• Hybrid semantic search over symbols: natural-language queries fused with keyword + graph expansion
• Git history backfill — temporal graph from commit history without touching the working tree
• Ten ways to consume the data: CLI, markdown report, MCP server (10 tools), pre-commit hook, CLAUDE.md injection
• An interactive visualization UI (2D/3D graphs, dependency matrix, treemap)

No build step. No npm. Zero required runtime dependencies — SQLite is stdlib.

---

Install

pip install codeindex

Or from source:

git clone https://github.com/scheidydude/codeindex
cd codeindex
pip install -e .

---

Quickstart

# Build the dependency index (also writes to .codeindex/index.db)
codeindex analyze ./myapp

# Build the symbol index (where every function and class lives)
codeindex symbols ./myapp

# See blast radius for a file before touching it
codeindex impact src/auth.py

# Search symbols with natural language (no embedding endpoint needed — FTS fallback)
codeindex search "validate auth token"

# See what changed since a release tag
codeindex changed-since v1.2.0

# Launch the visualization UI
codeindex serve --viz --repo ./myapp
open http://localhost:8080

---

Commands

codeindex analyze

codeindex analyze [REPO_PATH] [--output PATH] [--watch]

Analyzes the repo and writes codeindex.json to the repo root. Detects 12+ languages automatically.

Flag	Default	Description
REPO_PATH	.	Path to repo root
--output	<repo>/codeindex.json	Override output path
--watch	off	Re-index on file changes (requires watchdog)

---

codeindex symbols

codeindex symbols [REPO_PATH] [--output PATH] [--inline] [--index PATH]
                  [--claude-md] [--claude-md-path PATH] [--all-symbols]

Builds a symbol index — a map of every function, class, struct, and type to its exact file and line number. Lets AI tools (and humans) find any symbol in one lookup instead of scanning the entire repo.

Modes:

Flag	Description
(none)	Write a standalone symbolindex.json
--inline	Embed symbols into each node in codeindex.json instead
--claude-md	Append a compressed symbol summary to CLAUDE.md

Both --inline and --claude-md can be combined in a single run.

Options: