Config File

Location

sivtr stores config under the single home (SIVTR_HOME override, else ~/.sivtr):

Platform	Current path
All	`~/.sivtr/config.toml`

Full example

[editor]
command = "nvim"

[sync]
max_age_secs = 15

[hotkey]
chord = "alt+y"

[theme]
mode = "auto"

[mcp]
idle_exit_secs = 60

[embedding]
endpoint = "https://api.openai.com/v1/embeddings"
model = "text-embedding-3-small"
api_key_env = "OPENAI_API_KEY"
batch_size = 64

[pty_proxy]
enabled = true

editor

[editor]
command = "nvim"

Key	Type	Default	Meaning
`command`	string	`""`	Editor command. Empty means auto-detect.

Examples:

command = "hx"
command = "nvim"
command = "vim"
command = "code --wait"

sync

[sync]
max_age_secs = 15

Key	Type	Default	Meaning
`max_age_secs`	integer	`15`	How stale the archive may be (seconds since the last sync) before a query triggers an incremental re-sync. `0` re-lists on every query.

embedding

[embedding]
endpoint = "https://api.openai.com/v1/embeddings"
model = "text-embedding-3-small"
api_key_env = "OPENAI_API_KEY"
batch_size = 64

Semantic and hybrid search require an explicit OpenAI-compatible embeddings endpoint. The endpoint must use HTTPS, except for loopback HTTP during local development. If api_key_env is empty, no authorization header is sent.

hotkey

[hotkey]
chord = "alt+y"

Key	Type	Default	Meaning
`chord`	string	`"alt+y"`	Chord used by `sivtr hotkey start`

theme

[theme]
mode = "auto"

Key	Type	Default	Meaning
`mode`	string	`"auto"`	TUI color scheme: `auto`, `dark`, or `light`

auto follows the system appearance (macOS/Linux XDG/Windows registry) and picks the truecolor vs ANSI palette from terminal capability. dark and light force a palette. The key rejects unknown values and typos (e.g. mode = "ligth" is a hard error).

mcp

[mcp]
idle_exit_secs = 60

Key	Type	Default	Meaning
`idle_exit_secs`	integer	`60`	Seconds without tool calls before the stdio MCP server exits; `0` keeps it alive until the host closes stdin. The `sivtr mcp serve --idle-exit` flag overrides this.

pty_proxy

[pty_proxy]
enabled = true

Key	Type	Default	Meaning
`enabled`	boolean	`true`	Run the shell inside the capture proxy and record command output.

After sivtr init <shell|all> or sivtr setup, restart the shell to begin capturing. Older configurations without this field use true. To pause capture, set it to false with sivtr config edit; hook installation, upgrades, and repeated setup preserve an explicit opt-out. Restart the shell after changing the setting.