Configuration reference

Veska's state lives under ~/.veska/ (override with VESKA_HOME). Configuration is one TOML file (~/.veska/config.toml) plus the environment variables below. Env vars override the matching TOML key.

TOML keys and semantics

This page lists the environment variables, extracted from the internal/platform/config source so the list stays complete. For the full TOML schema, defaults, and which keys the daemon reads today, see the canonical Configuration Surface doc.

Environment variables

Variable	Purpose
VESKA_AUTOLINK_THRESHOLD	Autolink similarity threshold (float).
VESKA_AUTOLINK_TOPK	Autolink candidate count (integer).
VESKA_CACHE_DECLINED_TTL	How long a declined cache entry stays suppressed.
VESKA_CACHE_HOME	Cache root override (else XDG_CACHE_HOME, else a default under ~/.cache).
VESKA_CACHE_MAX_BYTES	Cache size ceiling in bytes (0 = unbounded).
VESKA_CACHE_MAX_EPHEMERALS	Max number of ephemeral cache entries retained.
VESKA_CONFIG	Explicit path to the TOML config file (overrides the VESKA_HOME-derived default).
VESKA_DEBUG	Enable debug logging when set to a non-empty, non-0 value.
VESKA_EMBED_MODEL	Embedding model name (default nomic-embed-text; only relevant when forcing an Ollama embedder).
VESKA_HOME	Data root. All of Veska's state lives here (default ~/.veska).
VESKA_HUB_THRESHOLD	Blast-radius hub-degree threshold (integer).
VESKA_OLLAMA_URL	Ollama base URL for the optional LLM features - review pipeline and per-node summaries (default http://localhost:11434).
VESKA_OTLP_ENDPOINT	OTLP endpoint for tracing export (required when tracing is enabled).
VESKA_VECTOR_BACKEND	Vector store backend: memory (default) or usearch.

A new VESKA_* env var that lands in the config source without a row here makes make docs-gen regenerate this page; CI then fails the staleness check until the page is committed.