快速开始

sivtr 有两条日常路径：

• 给人用：打开 sivtr TUI 面板，一起浏览终端输出和 Agent 会话，跨来源搜索，再复制真正需要的片段。
• 给 Agent 用：安装内置 sivtr-memory skill，然后通过 sivtr search、sivtr copy --print 和 sivtr show 等 CLI 指令检索本地 workspace memory。

1. 安装 CLI 和 skill

先按安装完成准备。重点是 Agent 工作流需要两个部分都在位：

• sivtr CLI 必须在 PATH 中可用；
• 内置 sivtr-memory skill 必须用 npx skills add Ariestar/sivtr --skill sivtr-memory -g 安装。

之后你就可以要求 Agent “先用 sivtr 查”，它会有明确流程去搜索本地记忆。

2. 先让终端记录进入 workspace

如果是第一次使用，先安装一次 shell 集成：

sivtr init powershell
# 或：sivtr init bash
# 或：sivtr init zsh
# 或：sivtr init nushell

重启 shell，然后照常工作：

bun run build
cargo test
git status --short

这一步会让最近命令和输出出现在 workspace 里。Agent 会话（Claude、Codex、Hermes、OpenCode、Pi）会从各自的本地 session 目录读取。

3. 打开统一 workspace TUI

运行：

sivtr

这是最重要的入口。它不是只看 terminal，也不是只看某一个 Agent，而是把当前机器上的本地工作记忆合在一个界面里。

Workspace TUI 有四个面板：

面板	用途
Source	选择来源，比如 terminal、Claude、Codex、Hermes、OpenCode、Pi
Sessions	选择某个终端记录或 Agent session
Dialogues	选择某轮对话或命令块
Content	查看具体输入、输出、工具结果或正文

常用按键：

按键	动作
0 / 1 / 2 / 3	聚焦 Source、Sessions、Dialogues、Content 面板
j / k	在当前面板上下移动
h / l	切换到前一个 / 后一个面板
Space	切换当前 source、session 或 dialogue
/	搜索 workspace
n / N	下一个 / 上一个搜索结果
i	复制输入或问题
o	复制输出或回答
y	复制输入 + 输出
c	复制裸命令（可用时）
:	给下一次复制设置行过滤
t	打开当前内容的 full view
z	当前面板全屏
?	帮助
q / Esc	返回或退出

Workspace 搜索支持前缀：

写法	搜索范围
error	内容
#build	对话 / 命令块标题
>release	session 标题

4. 只打开某一类内容

统一 workspace 是默认入口。如果你只想看某一类内容，可以用更具体的 picker。

只看最近终端命令块：

sivtr copy --pick

只看某个 Agent provider：

sivtr copy claude --pick
sivtr copy codex --pick
sivtr copy opencode --pick
sivtr copy pi --pick

这些是过滤后的 workspace 视图，不是主入口。

5. 需要快速复制时，用命令直接取

已经知道要拿什么时，不必打开 TUI：

sivtr copy          # 最近一次命令 + 输出
sivtr copy out      # 最近一次输出
sivtr copy cmd      # 最近一次命令
sivtr copy out 2    # 上一次命令输出
sivtr copy 2..4     # 一段最近命令块

读取 Agent 会话：

sivtr copy claude out --print
sivtr copy codex out --print
sivtr copy opencode out --print
sivtr copy pi out --print

给 Agent 用时通常加 --print，避免打开交互界面或只写入剪贴板。

6. 让 Agent 先查 workspace memory

当你遇到报错，可以直接说：

解决刚才的终端报错，先用 sivtr 查。

Agent 应该搜索同一份 workspace memory：

sivtr search terminal --match "error|failed|panic|Traceback|Exception|exit code|FAILED" --format json --limit 20
sivtr search terminal --status failure --latest 1 --format json
sivtr copy out 1 --print
sivtr copy cmd 1..10 --print

然后它再读代码、修复问题、重新运行验证命令。

这就是 sivtr 的核心价值：你在统一 workspace 里能看到的东西，Agent 也能用命令读取。

7. 用 ref 回到精确证据

搜索结果会包含 ref。ref 可以指向终端命令块、Agent session、某轮 dialogue，或其中一段内容。

sivtr search terminal --match "build error" --format json --limit 20
sivtr show terminal/current/2
sivtr show claude/<session>/3
sivtr show claude/<session>/3/2

Ref 让人和 Agent 回到同一份证据，而不是凭印象复述。

8. 单次长输出也可以打开 browser

除了 workspace TUI，sivtr 也有一个单缓冲区 browser，适合临时查看一段长输出：

cargo test 2>&1 | sivtr
sivtr run bun run build

这个界面只浏览当前这次输出；裸 sivtr 打开的 workspace TUI 才是统一查看终端和 Agent 记忆的主入口。

下一步

• 阅读心智模型理解 source、session、dialogue、block 和 ref。
• 看玩法实例了解真实工作流。
• 查看浏览和选择学习完整 workspace TUI 操作。
• 查看 CLI 参考确认精确选项。