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

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.