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.