用命令查找、继续或整理会话。

先确认 CLI 可用

桌面端进入“设置 → CLI & Agent”查看 CLI 文件、swob 命令和 Agent Skill 三项状态。缺少时点击安装；若系统不允许自动创建命令入口，设置页会给出需要人工执行的最小命令。

安装后在终端验证：

swob --version
swob --help
swob doctor library --json

成功状态： 三条命令均返回；带 --json 的命令在 stdout 只输出合法 JSON。若终端提示 command not found，先重新打开终端并检查设置页给出的 CLI 路径，不要复制或编辑 Library 文件来绕过安装问题。

本页按当前 v1.4 源码编写。若本机 swob --help 没有某条命令，以安装版本为准。

按任务选择命令

从一句原文找回并继续

先搜正文，再核对完整内容，最后才生成 Resume 命令：

swob grep "permission denied" --project swob --limit 10
swob show <session-id> --full
swob resume <session-id>

1. 从 grep 结果取得精确 session ID，不要仅凭标题判断。
2. 用 show --full 核对来源、项目、消息和工具调用。
3. resume 返回 { "command": "..." }；它生成命令，不把“命令已生成”当成“目标会话已恢复”。
4. 执行返回的命令后，在目标工具中核对上一轮内容。

把完整会话交给 Agent

Agent 应通过 CLI 读取受控、结构化输出，不直接遍历或修改 Library：

swob install
swob grep "writer-blocked" --project swob --limit 5
swob show <session-id> --full --format=jsonl

show --format=jsonl 每行是一个独立事件，适合流式处理；--full 会包含正文、thinking、工具参数和结果，可能带有敏感内容。只把完成任务所需的最小结果交给下游工具。

批量整理，并保留撤销入口

先读取文件夹 ID，再把整批计划通过 stdin 一次提交：

swob folders
printf '{"sessionId":"<id>","folderId":"work"}\n' | swob move --stdin
swob undo

• move --stdin 和 rename --stdin 先验证整批输入，再提交事务。
• 不要把界面显示名称猜成 folder ID；先运行 folders。
• undo 只撤销最近一次组织事务，不能代替备份，也不会覆盖后来占据原位置的内容。

先诊断，再重建一条 transcript

swob doctor library --json
swob transcript status <session-id> --json
swob transcript rebuild <session-id> --dry-run
swob transcript rebuild <session-id>

只有 doctor 和 status 证明问题在派生 transcript 时才进入重建。优先修一条，不要直接运行全库重建；不要手动删除 writer 锁或编辑 transcript。

写脚本前再看这些约定

• --json 时 stdout 只包含合法 JSON，诊断写 stderr。
• show --format=jsonl 每行一个独立 JSON 事件。
• 批量 move/rename 整批先校验再提交；undo 只撤销最近一次组织事务。
• token 汇总的 input_plus_output 不包含 cache creation/read。
• where、doctor 和 transcript status 是只读控制面，不依赖读取会话正文。

完整命令参考（29 条）