用途:把 Claude Code 会话的 JSONL 文件转换成按打字效果播放对话的动画 GIF,用于制作开发流程演示、为拉取请求补充可视化证据、分享会话亮点到 Slack 或 GitHub,以及嵌入教程。
主要能力:技能分三步执行——把会话文件解析为多轮对话、根据这些轮次生成 VHS tape、再交给 scry 渲染 GIF。解析会提取用户与助手轮次、跳过 sidechain(子代理)记录、把工具调用压缩为可读摘要、按配置宽度换行并按行数截断长回复。生成 tape 时包含 Output 指令与 Set 命令,用户消息以每字符 30ms 带 $ 前缀输入,助手回复 15ms/char,工具摘要 100ms 并缩进两格,轮次间暂停 1.5 秒,末尾定格 3 秒,所有节奏按 --speed 缩放,超出 --max-duration 则截断。
使用方式:可用 /session-replay 交互式选择最近会话(从 ~/.claude/projects/ 列出,显示项目名、首条用户消息预览、轮次数与修改时间),或直接传入文件路径;选项包括 --turns 选择轮次范围、--show 指定显示层(user、assistant、tools、thinking,thinking 默认排除)、--speed 与 --output。
限制:不适用于从会话写博客(用 scribe:session-to-post)、生成 API 文档(用 scribe:doc-generator)或录制实时终端命令(用 scry:vhs-recording)。需安装 VHS,未安装时提示 go install github.com/charmbracelet/vhs@latest;GIF 渲染依赖 scry 插件。若无路径且未找到会话,会提示直接提供路径。相关脚本方法名称与临时文件路径等细节见资料,其余未提供。