furkankly/zoetrope

这是什么？

核心功能

• 01为每个 agent、子 agent 和工作流分组绘制节点，显示状态与工具数量。
• 02工具调用以标签形式显示在对应 agent 下方，并标明成功或失败。
• 03可回放已结束的会话，也可实时跟随运行中的会话，时间轴支持拖动定位。
• 04向后拖动时间轴可精确还原当时的会话状态。
• 05点击 agent 可查看派生它的提示词、所用模型以及带耗时的工具调用记录。
• 06支持终端和浏览器两种界面，并提供无界面的 inspect 模式。

适用场景

• 观察长时间运行的 Claude Code 或 Codex 会话，了解哪些子 agent 正在工作。
• 回顾已完成的 agent 运行，理解任务如何被分派以及用到了哪些工具。
• 通过在任意时间点回放历史，调试 agent 工作流。
• 在没有终端的机器上，用无界面命令检查会话结构。

快速上手

1. 1

   使用 Homebrew 安装

   brew install furkankly/tap/zoetrope
2. 2

   或使用 Cargo 安装

   cargo install zoetrope
3. 3

   运行以跟随当前项目的实时会话

   zoe

使用前须知

• !依赖 Claude Code 和 Codex 未公开文档的转录格式，这些格式可能随时变化。
• !这是只读查看器，不能控制或运行智能体会话。

标签

常见问题

zoetrope 是什么？

在终端或浏览器中把 Claude Code 与 Codex 会话实时绘制成流程图，展示各个 agent 及其工具调用。 zoetrope 读取 Claude Code 和 Codex 为每次会话写入的 transcript 文件，把会话绘制成一张图：主 agent、它派生的子 agent，以及每个 agent 运行的工具。图会随会话推进实时更新。已结束的会话可以按设定速度回放，节奏取自会话自身的时间戳；仍在运行的会话则可以边生成边跟随。

zoetrope 可以免费使用吗？用的什么许可证？

zoetrope 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

zoetrope 还在维护吗？

活跃维护中。zoetrope 最近一次提交是在 2026年10月14日。

zoetrope 适合用来做什么？

观察长时间运行的 Claude Code 或 Codex 会话，了解哪些子 agent 正在工作。 回顾已完成的 agent 运行，理解任务如何被分派以及用到了哪些工具。 通过在任意时间点回放历史，调试 agent 工作流。 在没有终端的机器上，用无界面命令检查会话结构。

zoetrope 怎么安装和运行？

使用 Homebrew 安装: brew install furkankly/tap/zoetrope 或使用 Cargo 安装: cargo install zoetrope 运行以跟随当前项目的实时会话: zoe

在哪里获取 zoetrope？

源代码和安装说明在 GitHub 上：https://github.com/furkankly/zoetrope