furkankly/zoetrope

What it solves

Zoetrope 提供了一种可视化方式来监控和审查 AI 代理会话。用户不再需要阅读来自 Claude Code 或 Codex 等工具的长篇、线性文本转录文件，而是可以将整个过程视为一个实时的、交互式流程图。这使得理解主代理与其产生的子代理之间的关系，以及它们执行的工具调用序列变得更加容易。

How it works

Zoetrope 读取 AI 代理创建的内部转录文件 (JSONL)。它将这些转录文件视为仅限追加的事件日志，并将其解析为代理、提示词 (prompts) 和工具调用的模型。

它提供两种查看数据的方式：

• Terminal UI: 使用 Rust 和 Ratatui 构建的原生二进制文件，在终端中渲染图形。
• Browser: 同一个引擎的 WebAssembly (WASM) 版本，允许用户直接将转录文件拖入浏览器窗口。

该系统使用独立的“内容时钟”(content clock)（基于会话时间戳）和“呈现时钟”(presentation clock)（用于动画），允许用户在会话历史中进行滚动 (scrubbing)，暂停，或实时跟随正在运行的会话边缘。

Who it’s for

Claude Code 和 Codex 的开发者和高级用户，他们希望对代理型工作流进行高层级的可视化总览，并具备“穿越时空”能力来查看会话执行过程，以及查看每个代理动作背后的特定提示词和推理过程。

Highlights

• Live Flow Graph: 将主代理及其产生的子代理可视化为具有实时状态和工具活动的节点。
• Time Travel: 可滚动的进度条允许用户前后跳转，查看会话在任何给定时刻的精确状态。
• Detailed Inspection: 点击代理会显示其来源，包括生成它的提示词、推理过程以及带有时间戳的具体工具调用。
• Local-First & Private: 完全在本地机器上运行，没有任何网络依赖，确保转录文件永远不会被上传。
• Portable Core: 用 Rust 编写的单一引擎，同时驱动终端和浏览器界面。