EKOSdocs
Docs / Reference Operate

Configuration Reference

Every ekos.toml key.

Keys are kebab-case. Unknown top-level sections are rejected, except tables under [extensions.<name>], which core keeps for the extension that reads them. ekos config schema --json prints every section and setting with its type, default and description.

Section Key Type Default
[workspace] root path "."
log-level string "info"
log-format pretty|json "pretty"
[observe] paths list of paths [] (["."] from ekos init)
ignore-patterns list of exact directory or file names (not globs) [".ekos", ".git", "target", "node_modules"]
git-max-commits int (newest commits read from git history) 500
[[sources]] name, path string, path — a project's named inputs (RFC 0178); the name keys the source's objects —
kind dir|git (git reports a missing .git) dir
[[databases]] name, connect, user strings (RFC 0211/0235) required
kind oracle|postgres|clickhouse required
password-env env-var name (there is no password key) required
owners list of schemas (databases, for ClickHouse) required
profile p0|p1|p2 (Oracle only) p0
dictionary idempiere (Oracle only) unset
[llm] provider anthropic|ollama|openai|zen unset
model string unset
api-key-env env-var name unset
base-url URL (openai: any OpenAI-compatible host) OpenAI
context-window int (ollama only) 8192
max-tokens int (compiler-pass calls) per pass
fallback models tried on 429 / 5xx []
budget-usd float: refuse a metered call that could pass it unset
prices per-model price overrides {}
reasoning-effort, prompt-cache, allow-data-collection unset, unset, false
[llm.tasks.<task>] any [llm] key, per task (sql-naming, doc-semantics, description, semantics, ask, translate, xref-triage, …) inherited
[ai] model, max-matches, neighborhood-depth, max-tokens, system-prompt, reason-system-prompt, max-context-chars, source-text-top-k unset
[document-semantics] enabled, max-sections bool, int false, unset
[architecture-reasoning] enabled bool false
[llm-description] enabled bool false
scope modules|symbols|all modules
[binary-reconstruction] enabled bool false
max-slices int 50
min-confidence float 0.5
include-compiler-generated bool false
[embeddings] enabled bool false
provider ollama|openai|mock [llm] provider
model string provider default
api-key-env env-var name OPENAI_API_KEY
cache bool true
[retrieval] rerank "llm" or unset unset
rerank-candidates int built-in
[recover.sql] default-dialect string "generic"
[[recover.sql.dialect-rules]] path-glob, dialect strings —
[security] extra-excluded-globs list []
[[security.extra-patterns]] label, regex strings —
[clickhouse] enable-mcp-query bool false
[[architecture.system-decomposition.overrides]] layer overrides —
[storage] active-container string unset
[[storage.containers]] name, path —
[storage.partition] dimension, time-bucket (default monthly), time-bucket-overrides, segment-backend-url unset
[storage.distributed] coordinator, query-workers host:port unset
[session-memory] enabled bool false
max-note-chars, max-entries-per-session, max-bytes-per-session int 2000, 200, 262144
capture-retention-days int 14
extraction bool (LLM claim proposals) false
inbox-dir path .ekos/session/inbox
[conflicts] enabled bool (keep both claims when sources disagree) true
[freshness] enabled bool (compare the source with what the ledger was compiled from; metadata only) true
ttl-seconds int (MCP server reuses one check this long) 30
content-hash bool (a SHA-256 per file, so a touch is not a change) false
[xref] enabled bool (ekos commit writes the integrity index) true
min-confidence float 0–1 0.0
ignore-file path, relative to the state directory xref-ignore.toml
severity per-kind severity, e.g. UnresolvedReference = "warning" built-in
entry-points globs over symbol names for reachability roots unset
[tickets] keys exact issue-tracker project keys (IDEMPIERE) []
[review.scope] table classes by name for the review's scope subject (RFC 0213) built-in
[docs-estate] licences (source or database → SPDX id, or none), max-er-tables {}, 30
[semantics] enabled bool false
rationale bool (git blame -w on evidence lines) true
min-sites int (statements a filter must recur in to become a concept) 2
max-enum-values int (more distinct literals = a key, not a code) 12
llm-definitions bool (cited AI summaries; metered with a cloud provider) false
llm-max-definitions int 50
ontology path to a vocabulary file unset
[migrate] enabled bool false
project string (written by ekos migrate init) unset
default-environment string; never production "sandbox"
policy path to the RFC 0161 approval policy migrate.policy.toml
source-named-collection ClickHouse named collection holding the source credential "ekos_migrate_source"
chunk-rows int 100000
[migrate.connections.<alias>] host, user string required
port int 5432
secret-env env-var name (there is no password key) unset
max-replica-lag-seconds float 30.0
[marketing] publishing agent settings; X publishing stays off until explicitly enabled —
[extensions.<name>] an extension's own settings, never read by core —

ekos config validate is the check. See also Configuration File and Environment Variables. The web console's own settings (sign-in, owners, MCP limits) are not in ekos.toml: they come from the environment, the keychain and <home>/control/console.toml.