Skip to content

reference configuration

Bryan edited this page Jun 13, 2026 · 1 revision

Configuration

Lode configuration comes from CLI flags, environment variables, and a few fixed defaults in src/lode/config.py.

Data paths

Value Source Description
Data directory src/lode/config.py Defaults to ~/.local/share/lode/.
SQLite path src/lode/config.py Defaults to lode.sqlite under the data directory.
Kuzu path src/lode/config.py Defaults to lode.kuzu/ under the data directory.

CLI flags

Most commands accept --data-dir from src/lode/cli.py. Search-like commands also accept --repo and --limit, while context accepts --budget, and impact accepts traversal controls such as --depth, --max-nodes, and --direction.

Daemon flags

src/lode/daemon.py accepts:

Flag Default Purpose
--host 127.0.0.1 Bind address.
--port 7979 HTTP port.
--data-dir default data directory SQLite and Kuzu storage root.

Environment variables

Variable Used by Purpose
LODE_FEATURE_METRICS src/lode/features.py, src/lode/daemon.py Enables /metrics.
LODE_EMBEDDINGS_URL src/lode/cli.py, docker-compose.yml Embedding endpoint URL.
LODE_EMBEDDINGS_MODEL src/lode/cli.py, docker-compose.yml Embedding model name.
LODE_UID, LODE_GID docker-compose.yml Container user and group IDs.

Related pages

Clone this wiki locally