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

🚀 Features

• (herdr) Open the focused agent pane's session by @furkankly in #21
• (provider) Read Codex sessions by @furkankly in #19

🚜 Refactor

• (api) Decide what the crate exposes by @furkankly in #20
• Put a provider boundary between the transcript and the model by @furkankly in #18

📚 Documentation

• Document the homebrew and prebuilt binary installs by @furkankly

⚡ Performance

• (state) Seek backward from a snapshot ladder instead of item zero by @FoamScience in #17

🧪 Testing

• (bench) Price the ladder by dropping it instead of seeking through it by @furkankly

Full Changelog: 0.1.0...0.2.0

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

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

First release.

Claude Code writes a JSONL transcript for every session under ~/.claude/projects/. zoetrope reads it and draws the session as a graph in your terminal: the main agent, the subagents and workflows it spawns, and the tools each one runs. 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.

One scrubbable timeline covers both. Seek backwards and the graph shows what was true at that moment: agents un-finish, tool counts fall. It's read-only, and nothing leaves your machine.

cargo install zoetrope puts the binary on your path as zoe. The same engine runs in the browser at zoetrope.furkankly.dev/app: drop a transcript on the page and get the same graph.