04 · GENERATED CLI

CLI 1.3.1 全命令

本页命令、摘要、输出和示例与 /swob skill 使用同一个 command registry。改代码不重新生成，测试会失败。

24 条命令机器输出优先 JSON

机器接口约定

--json 时 stdout 只包含合法 JSON，诊断写 stderr。
show --format=jsonl 每行一个独立 JSON 事件。
批量 move/rename 整批先校验再提交；undo 只撤销最近一次组织事务。
token 汇总的 input_plus_output 不包含 cache creation/read。

退出码	含义
`0`	成功
`1`	参数、输入或执行错误
`2`	标识符歧义
`3`	目标不存在

命令参考

`swob search <query> [--limit N]`

按标题、项目、文件夹等元数据搜索会话

输出: JSON 会话数组
示例: swob search "认证失败" --limit 10

`swob list [--folder ID|NAME] [--source SOURCE] [--project TEXT] [--limit N]`

列出并筛选会话

输出: JSON 会话数组
示例: swob list --project swob --source codex

`swob show <sessionId> [--full] [--format=jsonl]`

查看会话；--full 保留全文、thinking、工具参数和结果

输出: JSON 对象；jsonl 模式每行一个 session/message 事件
示例: swob show <id> --full
swob show <id> --full --format=jsonl

`swob grep <query> [--source SOURCE] [--folder ID|NAME] [--after DATE] [--before DATE] [--project TEXT] [--limit N]`

用 SQLite FTS 搜索完整 transcript，并返回命中消息上下文 ±1

输出: JSON 搜索结果
示例: swob grep "permission denied" --project swob --after 2026-07-01

`swob resume <sessionId> [--cwd PATH] [--skip-permissions]`

生成恢复会话的命令

输出: JSON { command }
示例: swob resume <id>

`swob resume-audit [--json]`

只读审计全部会话的恢复可信度

输出: 文本报告；--json 时为 JSON
示例: swob resume-audit --json

`swob resolve <sessionId> [--json]`

把旧 ID 或短 ID 解析为最新完整 ID

输出: 默认一行 ID；--json 时为 JSON
示例: swob resolve <short-id> --json

`swob lineage [--dry-run]`

重建会话血统注册表

输出: JSON 注册表
示例: swob lineage --dry-run

`swob folders`

列出 Vault 文件夹树

输出: JSON 文件夹树
示例: swob folders

`swob folder create <name> [--parent ID]`

创建文件夹

输出: JSON 结果
示例: swob folder create "swob"

`swob folder rename <id> <name>`

重命名文件夹

输出: JSON 结果
示例: swob folder rename work "工作"

`swob folder delete <id>`

删除空的受管文件夹

输出: JSON 结果
示例: swob folder delete archive

`swob move <sessionId> <folderId>`

事务式移动一个会话

输出: JSON 结果
示例: swob move <id> work

`swob move --stdin`

从 stdin 读取 JSONL 或 JSON 数组，原子提交批量移动

输出: JSON 事务结果
示例: printf '{"sessionId":"<id>","folderId":"work"}\n' | swob move --stdin

`swob rename <sessionId> <title>`

事务式重命名一个会话

输出: JSON 结果
示例: swob rename <id> "CLI 设计"

`swob rename --stdin`

从 stdin 读取 JSONL 或 JSON 数组，原子提交批量重命名

输出: JSON 事务结果
示例: printf '{"sessionId":"<id>","title":"CLI 设计"}\n' | swob rename --stdin

`swob undo`

撤销最近一次 move/rename 组织事务

输出: JSON 事务结果
示例: swob undo

`swob insights [--json] [--summary]`

查看会话统计；token 汇总明确标注 input_plus_output

输出: JSON 统计
示例: swob insights --summary

`swob config get [key]`

读取设置

输出: JSON
示例: swob config get terminalApp

`swob config set <key> <value>`

修改设置

输出: JSON
示例: swob config set terminalApp iTerm2

`swob active`

列出活跃会话

输出: JSON
示例: swob active

`swob transcript rebuild --all [--dry-run] [--missing-only]`

重建 Library transcript

输出: JSON
示例: swob transcript rebuild --all --missing-only

`swob redact [--dry-run]`

对派生 transcript 回填脱敏

输出: JSON
示例: swob redact --dry-run

`swob install`

安装或更新 CLI wrapper 和本 Skill

输出: JSON 安装结果
示例: swob install