Configuration

sivtr uses a TOML config file in the platform config directory. Configuration controls editor handoff, history retention, Codex mirrors, TUI theme, MCP idle exit, and the Windows hotkey chord.

Commands

sivtr config show
sivtr config init
sivtr config edit

Command	Behavior
sivtr config show	Print config path and effective file content or defaults
sivtr config init	Create the default config if it does not exist
sivtr config edit	Create the config if needed and open it in the configured editor

Default config

[editor]
command = ""

[history]
auto_save = true
max_entries = 0

[codex]
session_dirs = []

[hotkey]
chord = "alt+y"

For a field-by-field reference, see Config File.

History retention

[history]
auto_save = true
max_entries = 0

max_entries = 0 means unlimited. Set auto_save = false when you do not want pipe and run captures written to history automatically.

Shared Codex session trees

Add shared exported Codex session trees when another account publishes a read-only copy:

[codex]
session_dirs = ["/srv/sivtr/root-codex/sessions"]

Create that shared tree from the source account with:

sivtr codex export --dest /srv/sivtr/root-codex
sivtr codex export --dest /srv/sivtr/root-codex --watch

Only Codex currently has first-class shared mirror configuration. Other registered providers are read from their local provider-specific locations. See Data Locations.

Hotkey chord

[hotkey]
chord = "alt+y"

This chord is used by sivtr hotkey start unless overridden with --chord.

Provider selection is a runtime CLI option, not a config key:

sivtr hotkey start --provider all
sivtr hotkey start --provider claude