travsr config
Inspect and set layered configuration. Settings resolve from a global layer and a per-repo layer, and the command tells you which one is actually in effect.
travsr config list
travsr config get embed.capacity
travsr config set embed.capacity 50
travsr config set embed.capacity 50 --now
travsr config set docs.enabled true --repo
travsr config unset embed.capacity
Subcommands
| Command | What it does |
|---|---|
get <KEY> | Show a key's active value and which layer set it |
set <KEY> <VALUE> [--repo] [--now] | Set a key. Writes the global layer unless --repo is given. --now applies an embed.* key immediately by restarting any in-flight embed reindex with the new value |
unset <KEY> [--repo] | Remove a key's override so it falls back to the default (or a lower layer). Clears the global layer unless --repo is given |
list [--json] | Every known key with its resolved value and source layer. --json emits JSON instead of a table |
Why the layer matters
A value that looks wrong is usually a value set somewhere you were not looking. get and list name the layer for exactly that reason, so "why is this 50 when I set 100" is answerable without hunting through files. The layer is one of env, repo config, global config or default.
$ travsr config get embed.capacity
100 (default, unset)
$ travsr config list
KEY VALUE SOURCE DESCRIPTION
--------------------------------------------------------------------------------------------
embed.capacity 100 (default) - Embedding worker budget: `auto` (load-adaptive) or a percent 1-100. 100 = full speed.
embed.max_workers auto (default) - Absolute hard cap on embedding reader threads (>= 1). Overrides capacity.
embed.priority normal (default) - OS scheduling priority for the embed sidecar: normal | low | idle.
docs.enabled true (default) - Retrieve documentation prose as a separate `docs` result section (true | false).
docs.max_results 3 (default) - Maximum entries rendered in the `docs` section (>= 1).
docs.budget_pct 20 (default) - Share of the token budget the `docs` section may claim, 1-100.
docs.exclude (none) (default) - Extra comma-separated path substrings excluded from doc indexing, beyond the built-ins.
guard.mode off (default) - Claude Code PreToolUse guard: off | advisory | strict. advisory nudges toward the graph, strict denies graph-answerable reads.
log.level info (default) - Daemon log verbosity written to daemon.log: error | warn | info | debug | trace. RUST_LOG overrides it.
Known keys
| Key | Default | Values |
|---|---|---|
embed.capacity | 100 | auto (load-adaptive) or a percent 1-100 |
embed.max_workers | auto | Absolute cap on embedding reader threads (>= 1). Overrides capacity |
embed.priority | normal | normal, low or idle |
docs.enabled | true | true or false |
docs.max_results | 3 | >= 1 |
docs.budget_pct | 20 | 1-100 |
docs.exclude | none | Comma-separated path substrings excluded from doc indexing |
guard.mode | off | off, advisory or strict. See travsr guard |
log.level | info | error, warn, info, debug or trace. TRAVSR_LOG_LEVEL sets it from the environment; RUST_LOG overrides it |
travsr config list is the authority; an unknown key is rejected rather than silently stored, so a typo cannot masquerade as a setting that never takes effect.