Home

Lode

Lode is a local-first repository knowledge graph for coding agents. It indexes Python, TypeScript/JavaScript, Markdown, and config files into SQLite, then answers symbol lookup, search, context-pack, neighbor, and impact-analysis questions without sending repository source to a hosted service.

What it does

The main product is the lode CLI from src/lode/cli.py, backed by indexing logic in src/lode/indexer.py, storage in src/lode/storage.py, and graph traversal in src/lode/graph.py. The same capabilities are exposed through the local loded HTTP daemon in src/lode/daemon.py.

graph LR
    Repo[Local repository] -->|scan and parse| Indexer[src/lode/indexer.py]
    Indexer -->|nodes and edges| SQLite[(SQLite)]
    SQLite -->|search and graph facts| CLI[src/lode/cli.py]
    SQLite -->|HTTP responses| Daemon[src/lode/daemon.py]
    CLI --> Agent[Coding agent]
    Daemon --> Agent

Loading

Who uses it

• Coding agents that need bounded JSON with file and line citations.
• Developers who want fast local search and symbol lookup.
• Maintainers who want to check callers, callees, and blast radius before changing code.

Key capabilities

Capability	Primary implementation
Repository indexing	src/lode/indexer.py
SQLite search and symbol lookup	src/lode/storage.py
Context packs	src/lode/context.py
Impact and blast-radius analysis	src/lode/graph.py
Local HTTP API	src/lode/daemon.py
Optional embeddings	src/lode/embeddings.py
Optional Kuzu projection	src/lode/kuzu_store.py

Start reading here

• Architecture explains the components and data flow.
• Getting started covers install, setup, and validation commands.
• Indexing describes how source files become graph facts.
• Impact analysis explains the "what might break?" workflow.

---

Generated by Factory