zoetrope

zoetrope 是一款将 Claude Code 会话实时渲染为动态流程图的终端工具，让开发者以可视化方式观察 AI 编程智能体的工作全貌。它读取 Claude Code 在 ~/.claude/projects/ 目录下生成的 JSONL Transcript，解析后以节点-边图形式绘制主智能体、子智能体和工作流组，并在终端实时更新。

【核心功能】 • 实时追踪：指向运行中项目的目录即可跟随 live session，或打开已完成的 JSONL 文件进行回放 • 时间旅行：拖动时间轴可在任意时刻回溯会话状态，节点会「反执行」——已完成的步骤会撤销、子智能体数量减少、工具计数回落 • 智能体状态：每个节点显示当前工具、工具调用次数和输出 token • 加速回放：支持 0.25x ~ 64x 变速，默认 8x • 终端 UI（TUI）模式：全程在终端运行，零网络请求

【图形渲染能力】 • 每个节点展示主智能体、子智能体和工作流组，嵌套显示父子关系 • 工具调用显示为节点下方的标签（如 ⚒ bash ×5），单次调用同时显示耗时 • 边在智能体工作时动画流动，结束时固定 • minimap：会话图过大时显示小地图 • Overview / Follow 两种相机模式：手动漫游或自动追踪当前活跃节点

【检查模式】 • 点击任意节点查看其来源信息：触发提示词、推理内容、模型名称、所有工具调用及耗时 • Session Info 浮层：运行模式、权限、队列操作、文件编辑数、上次提示词 • zoe inspect 命令：纯命令行打印会话树，无需 TTY

【隐私保证】 • 纯本地工具，依赖树中无 HTTP 客户端，网络功能默认关闭 • 不访问网络，数据不离开本机

【安装方式】 • macOS/Linux：brew install furkankly/tap/zoetrope • cargo install zoetrope • 直接下载各平台预编译二进制 • 在线体验：https://zoetrope.furkankly.dev/app

【适用场景】 AI 编程教学演示、调试复杂多智能体任务、代码审查、团队代码审查演示。Rust 语言，MIT 许可证。