furkankly/zoetrope

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

What it solves

Zoetrope provides a visual way to monitor and review AI agent sessions. Instead of reading through long, linear text transcripts from tools like Claude Code or Codex, users can see the entire process as a live, interactive flow graph. This makes it easier to understand the relationship between a main agent and the sub-agents it spawns, as well as the sequence of tool calls they execute.

How it works

Zoetrope reads the internal transcript files (JSONL) created by AI agents. It treats these transcripts as append-only event logs and parses them into a model of agents, prompts, and tool calls.

It offers two ways to view this data:

  • Terminal UI: A native binary built with Rust and Ratatui that renders the graph in the terminal.
  • Browser: A WebAssembly (WASM) version of the same engine that allows users to drop transcript files directly into a browser window.

The system uses a separate "content clock" (based on session timestamps) and "presentation clock" (for animations), allowing users to scrub through the session history, pause, or follow the live edge of a running session in real-time.

Who it’s for

Developers and power users of Claude Code and Codex who want a high-level visual overview of their agentic workflows, the ability to "time travel" through a session's execution, and a way to inspect the specific prompts and reasoning behind each agent's actions.

Highlights

  • Live Flow Graph: Visualizes the main agent and its spawned sub-agents as nodes with real-time status and tool activity.
  • Time Travel: A scrubbable timeline allows users to seek backwards and forwards, seeing the session exactly as it stood at any given moment.
  • Detailed Inspection: Clicking an agent reveals its provenance, including the spawning prompt, reasoning, and specific tool calls with timings.
  • Local-First & Private: Operates entirely on the local machine with zero network dependencies, ensuring transcripts are never uploaded.
  • Portable Core: A single engine written in Rust that powers both the terminal and browser interfaces.

Related

  • Project
    simple10/agents-observe

    A real-time observability dashboard for Claude Code and Codex agents that provides visibility into subagent hierarchies, tool calls, and token usage.

  • Project
    delexw/claude-code-trace

    A session log viewer for Claude Code that transforms raw local JSONL files into readable, interactive conversations across desktop, web, and TUI interfaces.

  • Project
    paulrobello/claude-office

    A real-time pixel art office simulation that visualizes Claude Code and OpenCode operations, turning agent logs into an animated environment with boss and employee agents.

  • Project
    daaain/claude-code-log

    A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML and Markdown formats for session review and token tracking.

  • Project
    JayantDevkar/claude-code-karma

    A local-first dashboard that visualizes Claude Code session data, providing analytics on costs, token usage, and tool activity from local JSONL files.