furkankly/zoetrope

What it solves

Zoetrope は、AI エージェントのセッションを監視・レビューするための視覚的な方法を提供します。Claude Code や Codex などのツールの長い、線形なテキストトランスクリプトを読み進める代わりに、ユーザーはプロセス全体をライブでインタラクティブなフローグラフとして見ることができます。これにより、メインエージェントとそれが生成するサブエージェントの関係、および実行されるツールコールのシーケンスを理解しやすくなります。

How it works

Zoetrope は、AI エージェントが作成する内部トランスクリプトファイル (JSONL) を読み取ります。これらのトランスクリプトを追記型のイベントログとして扱い、エージェント、プロンプト、ツールコールのモデルに解析します。

データを見るための 2 つの方法を提供します：

• Terminal UI: Rust と Ratatui で構築されたネイティブバイナリで、ターミナル内でグラフをレンダリングします。
• Browser: 同じエンジンの WebAssembly (WASM) 版があり、ユーザーはトランスクリプトファイルをブラウザウィンドウに直接ドロップできます。

このシステムは、個別の「コンテンツクロック」(content clock)（セッションのタイムスタンプに基づく）と「プレゼンテーションクロック」(presentation clock)（アニメーション用）を使用しており、ユーザーはセッション履歴をスクラブ、一時停止、または実行中のセッションのライブエッジをリアルタイムで追跡できます。

Who it’s for

Claude Code や Codex の開発者やパワーユーザーで、エージェントのワークフローをハイレベルな視覚的概要として把握したい、セッションの実行を「タイムトラベル」して確認したい、あるいは各エージェントのアクション背後にある特定のプロンプトや推論を確認したいと考えている方々です。

Highlights

• Live Flow Graph: メインエージェントとそのサブエージェントを、リアルタイムのステータスとツールアクティビティを持つノードとして可視化します。
• Time Travel: スクラブ可能なタイムラインにより、ユーザーは前後へシーク、セッションが特定の瞬間にどのような状態であったかを正確に確認できます。
• Detailed Inspection: エージェントをクリックすると、その生成プロンプト、推論、およびタイミング付きの具体的なツールコールが表示されます。
• Local-First & Private: ネットワーク依存なしにローカルマシン上で完全に動作するため、トランスクリプトがアップロードされることはありません。
• Portable Core: ターミナルとブラウザの両方のインターフェースを駆動する、Rust で書かれた単一のエンジンです。