数据位置

sivtr 是 local-first。它使用的大多数数据已经在你的机器上；它生成的数据默认写在平台配置或状态目录下，除非你显式导出到其他位置。

配置文件

平台	路径
Windows	%APPDATA%\sivtr\config.toml
macOS	~/Library/Application Support/sivtr/config.toml
Linux	~/.config/sivtr/config.toml

如果存在 legacy sift/config.toml 且当前 sivtr 配置不存在，sivtr 会读取 legacy 文件以保持兼容。

Shell session log

Shell 集成会写入按进程区分的结构化 session log。

Shell/平台	常见路径
Windows PowerShell / PowerShell 7	%APPDATA%\sivtr\session_<pid>.log
Bash / Zsh	$XDG_STATE_HOME/sivtr/session_<pid>.log 或 ~/.local/state/sivtr/session_<pid>.log
Nushell	Nushell config/state 区域中的 sivtr session 文件

这些 log 支撑：

• sivtr import；
• sivtr copy 命令块工作流；
• sivtr diff；
• browser 中的命令块导航。

History 数据库

当 [history].auto_save = true 时，捕获的终端输出会保存到本地 SQLite history 数据库。

请通过 CLI 命令访问，而不是直接编辑数据库：

sivtr history list
sivtr history search "panic"
sivtr history show 42

保留策略由以下配置控制：

[history]
max_entries = 0

0 表示不限制数量。

Agent provider 数据

sivtr 读取 provider 自己的本地数据，不上传 transcript。

Provider	数据来源
Codex	~/.codex/sessions rollout JSONL 文件
Claude Code	当前 transcript/session 环境变量和本地 Claude transcripts
Hermes	$HERMES_HOME/sessions；Windows 默认 %LOCALAPPDATA%\hermes\sessions，其他平台默认 ~/.hermes/sessions
OpenCode	OpenCode 本地数据库
Pi	Pi agent session JSONL 文件

各 provider 格式不同；sivtr 会把它们归一化为 session 和 dialogue unit，用于 copy、picker、search 和 show 工作流。

Codex 导出 mirror

codex export 会把本地 Codex session 文件复制到你选择的目标目录：

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

目标目录会包含一个 sessions/ 树。另一个账号可通过配置读取：

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

共享 mirror 尽量使用只读权限。

生成的启动器

Linux shortcut generation 会写入：

• ~/.local/bin/sivtr-pick-codex；
• ~/.local/share/applications/sivtr-pick-codex.desktop。

macOS shortcut generation 会写入：

• ~/.local/bin/sivtr-pick-codex；
• ~/Library/LaunchAgents/dev.sivtr.pick-codex.plist。

Windows hotkey 状态存放在 sivtr 的平台 config/state 区域下，由以下命令管理：

sivtr hotkey status
sivtr hotkey stop