RepoGraph is a local-first code intelligence engine for understanding large repositories. It indexes source code into SQLite and exposes a CLI plus terminal TUI for exploring architecture, search results, impacts, cycles, routes, and PR risk.
- Python + JavaScript/TypeScript indexing
- SQLite-backed repository graph
- CLI for indexing and analysis
- Textual TUI for overview, search, graph, impact, cycles, and explain
- Local-first workflow with optional Git-based risk analysis
Python backend
- CLI (Typer)
- TUI (Textual)
- Core analysis
- SQLite storage
- Python/JS parsers
uv sync --dev
uv run repograph index .
uv run repograph tui .For local development:
uv sync --dev
uv run repograph --help
uv run pytest tests --basetemp .pytest-tmpFor a tool-style install:
uv tool install --editable .
repograph --help- index Python and JS/TS files into SQLite + FTS5
- search repository content
- inspect routes
- explain a file's symbols, imports, routes, and related tests
- show direct and indirect impact of a change
- detect import cycles
- suggest likely dead code with confidence scores
- score PR risk from local Git diffs
- explore the graph from a terminal TUI
The earlier design questions are answered in the implementation like this:
- first workflows: onboarding to a new repo and impact analysis after a change
- local-first: all indexing is SQLite-based and offline
- optional config: not required for the first run
- graph interaction: focus-node neighborhood view with linked panels
- Git support: local diff and basic churn-based risk inputs
- plugin model: internal parser abstraction, no public plugin installation yet
uv run repograph index .
uv run repograph summary .
uv run repograph search login .
uv run repograph impact src/auth/session.py .
uv run repograph cycles .
uv run repograph routes .
uv run repograph dead-code .
uv run repograph explain src/api/users.py .
uv run repograph pr-risk main..HEAD .
uv run repograph tui .