配置

sivtr 使用平台配置目录中的 TOML 配置文件。配置控制打开模式、编辑器交接、history 保留、prompt 检测、Codex mirror 和 Windows 热键按键。

命令

sivtr config show
sivtr config init
sivtr config edit

命令	行为
sivtr config show	打印配置路径和有效文件内容或默认值
sivtr config init	如果配置不存在，则创建默认配置
sivtr config edit	必要时创建配置，并用配置的编辑器打开

默认配置

[general]
open_mode = "tui"
preserve_colors = true

[editor]
command = ""

[history]
auto_save = true
max_entries = 0

[copy]
prompts = []

[codex]
session_dirs = []

[hotkey]
chord = "alt+y"

字段级说明见配置文件。

在编辑器中打开捕获输出

[general]
open_mode = "editor"

[editor]
command = "nvim"

当 open_mode 是 editor 时，pipe mode、run mode 和 session import 会把捕获文本交给外部编辑器，而不是内置 TUI。

保留颜色

[general]
preserve_colors = true

启用后，TUI 可以在有 ANSI 内容时显示原始颜色。纯文本复制和搜索仍保持稳定。

Prompt 检测

如果你的 prompt 比较特殊，添加字面 prompt 前缀：

[copy]
prompts = ["dev>", "repo $", "PS C:\\repo>"]

这能帮助命令块解析识别 session log 中的命令输入行。

History 保留

[history]
auto_save = true
max_entries = 0

max_entries = 0 表示无限制。如果不希望 pipe 和 run capture 自动写入 history，设置 auto_save = false。

共享 Codex session tree

当另一个账号发布只读副本时，添加共享的 Codex session tree：

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

从源账号创建共享树：

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

目前只有 Codex 有一等共享 mirror 配置。其他 Agent provider 从自己的本地 provider 位置读取。见数据位置。

热键按键

[hotkey]
chord = "alt+y"

除非使用 --chord 覆盖，否则 sivtr hotkey start 会使用这个按键。

Provider 选择是运行时 CLI 选项，不是配置项：

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