Release Notes
sivtr 仍处在早期 0.1.x 开发阶段。本系列中 CLI 和配置格式仍可能变化。本页总结用户可见变更;仓库中的 CHANGELOG.md 仍是更详细的 changelog 来源。
Unreleased
Section titled “Unreleased”- 新增
sivtr filter:作为一等 WorkSet 过滤命令,可用于已保存变量、source selector 和 stdin@管道。 - 新增
sivtr var:管理命名 WorkSet 记忆,包含set、list、rm、merge、drop和cleanup。 - 新增
sivtr nav:用<、>N、+N、-N、[A..B]和~做确定性 anchor 移动。nav不会隐式展开 child anchors。 - 新增 Hermes agent session provider,支持 copy、picker、search、refs 和 WorkSet 工作流。
- 新增全局
--color auto|always|never,控制状态和诊断输出颜色。
Changed
Section titled “Changed”- 统一 CLI 状态和诊断消息,并保持输出到 stderr,避免污染 stdout 数据管道。
search和work parts现在共享同一套 WorkSet filtering 实现。
- 修复 Windows 上 Nushell shell integration:当 prompt 可见但 Nushell prompt closure 的环境变量修改不会泄漏到后续 hook 时,不再把命令输出捕获为空。
0.1.3 - 2026-05-24/25
Section titled “0.1.3 - 2026-05-24/25”- 新增基于 git root 的 workspace scoping,repo 子目录中打开的终端会解析到同一个 workspace。
- 新增
sivtr init all/sivtr init -all,可一次性安装所有受支持 shell hook。 - 新增 target-first search 语法:
sivtr search terminal|agent|codex|claude|opencode|pi ...。 - 新增 target path 缩小能力,可定位到 session、record/turn 和 line,例如
terminal/session_13104/3/12。 - 新增 search filters:字段(
--in)、状态、exit code、最小/最大 duration、cwd、时间范围、latest、limit、排除当前 session 和排序。 - 新增本地自然时间别名:
today、yesterday、tomorrow、this morning、this afternoon、this evening、tonight和now。 - 新增 search 输出格式:
--format timeline|compact|md|json。json仍是机器可读默认格式。 - 新增更干净的 search JSON snippet,
matches不再输出冗余line字段。 - 新增 OpenCode 和 Pi 的 Agent search/copy 覆盖,与 Codex、Claude Code 一起作为受支持 provider。
- 新增
WorkTime:包含started_at、ended_at、duration_ms,当能获得其中两个时推导第三个。 - 新增
sivtr version --verbose,用于打印 binary 路径、profile、git/build metadata、repo root 和本地 debug binary 诊断。
Changed
Section titled “Changed”- Search 现在把 target selection 和 filter 分开。旧的
--scope、--provider、--recent、--jsonsearch flags 已移除,改用 target-first 语法、--latest和--format json。 - Search/show timestamp 统一 normalize 为带 offset 的本地 RFC3339。
- Agent record title 会跳过
[skill:...]marker line,优先使用真实用户请求。 - Skill 注入内容会在 record 中压缩,避免 prompt 噪音主导 title 和 search snippet。
- WorkRecord 围绕稳定顶层
work_ref简化,减少重复的 source/id 数据,并保留结构化 text/payload 字段。 - Search 结果按 record/dialogue 分组并带 snippet,减少重复 line 噪音。
- 修复 terminal search 因 PowerShell 本地时间字符串(如
Mon May 25 00:35:02 2026)无法解析而返回空结果的问题。 - 修复 interrupted agent turns 无法稳定搜索的问题。
- 修复 record/time/search 重构后的 clippy warnings。
0.1.3 - 2026-05-20
Section titled “0.1.3 - 2026-05-20”- 新增用于浏览 AI session 的 workspace picker 体验,包括更丰富的内容渲染、搜索导航、滚动和带行号的内容视图。
- 新增 AI session workspace copy 快捷键:
i复制用户输入,o复制助手输出,y复制不带 role heading 的完整 dialogue block。 - 新增项目 roadmap 文档页面。
- 加固 VS Code picker command 在 PowerShell、cmd.exe、fish 和 POSIX shells 中的 quoting。
- 忽略 Claude
ai-titlemetadata event,避免 session parsing 失败。 - 修复 CI clippy warnings。
0.1.2 - 2026-05-02
Section titled “0.1.2 - 2026-05-02”- 将取消交互式 picker 视为正常退出。
0.1.1 - 2026-05-01
Section titled “0.1.1 - 2026-05-01”- 修复 Codex copy picker TUI 选择逻辑。
- 修复 terminal exit handling,避免终端卡住。
0.1.0 - 2026-04-28
Section titled “0.1.0 - 2026-04-28”- 新增
sivtr:用于捕获命令输出和 AI coding session 的终端输出 workspace。 - 新增 pipe mode:
command | sivtr。 - 新增 run mode:
sivtr run <command>。 - 新增 Vim 风格导航、modal interaction、visual selection、搜索和剪贴板复制。
- 新增带 full-text search 的本地 SQLite history。
- 新增 Codex session capture helper:通过
sivtr copy codex复用 assistant reply、user prompt 和 tool output。 - 新增命令块 copy、diff 和 picker 工作流。
- 新增 TOML 配置支持。
- 新增 Windows 全局热键支持,用于 Codex picker 工作流。
- 这是第一个公开版本。CLI 和配置格式在
0.1.x系列中仍可能变化。
当前文档覆盖范围
Section titled “当前文档覆盖范围”当前文档覆盖:
- 终端 pipe 和 run capture;
- shell session logging;
- TUI 浏览和选择;
- 命令块 copy 和 diff;
- Codex、Claude Code、OpenCode 和 Pi 的 AI session copy 与 picker 工作流;
- workspace search 和 show refs;
- SQLite terminal history;
- TOML 配置;
- Windows hotkey、VS Code、tmux、Linux shortcut 和 macOS launcher 流程。