zoetrope

zoetrope

  Watch a Claude Code or Codex session as a live flow graph, in your terminal or your browser.

  zoetrope.furkankly.dev · the whole app in your browser, the same binary compiled to WASM

Claude Code and Codex write a transcript for every session. zoetrope reads it and draws
the session as a graph in your terminal: the main agent, the agents it spawns, and the
tools each one runs, updating live as it goes. Point it at a finished run and it replays,
paced by the session's own timestamps. Point it at a running one and it follows along.
It's read-only, and nothing leaves your machine.

Built on ratatui and rataflow.

Supported agents

zoetrope reads a session from any of its files and tells the formats apart by
content, so zoe  works for either, and zoe  finds a session by id
across both.

Installation

Homebrew — macOS and Linux:

Cargo — needs a Rust toolchain:

Prebuilt binaries — no toolchain needed. Every
release carries archives for
macOS (Apple Silicon and Intel), Linux (musl, arm64 and x86_64) and Windows
(x86_64). Unpack one and put zoe on your PATH.

Whichever route you take, the command is zoe. Or build from source:

No install at all: try it in your browser.
Drop a transcript on the page and get the same graph.

In Herdr

Herdr is a terminal multiplexer built for running coding
agents side by side. It knows which agent occupies a pane and the id of the
session running there, so the plugin in
herdr-plugin/
opens that exact session in zoe, without you naming a file or an id.

Focus an agent pane and press prefix+shift+z. The graph opens over the pane,
follows the session live, and the same key closes it. There are placements for
a split and a tab as well, and the plugin's
README
covers both.

Usage

Give it a file and it reads the whole transcript,…