Skip to main content
← CLI Reference

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​

CommandWhat 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​

KeyDefaultValues
embed.capacity100auto (load-adaptive) or a percent 1-100
embed.max_workersautoAbsolute cap on embedding reader threads (>= 1). Overrides capacity
embed.prioritynormalnormal, low or idle
docs.enabledtruetrue or false
docs.max_results3>= 1
docs.budget_pct201-100
docs.excludenoneComma-separated path substrings excluded from doc indexing
guard.modeoffoff, advisory or strict. See travsr guard
log.levelinfoerror, 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.