Repolode
furkankly

furkankly/zoetrope

Claude CodeとCodexのセッションを、エージェントとツール呼び出しのライブフローグラフとして表示するターミナル/ブラウザ用ビューア。

スター
1,062
フォーク
73
未解決の Issue
13
最終コミット
6 日前

これは何?

zoetropeは、Claude CodeとCodexがセッションごとに出力するトランスクリプトファイルを読み込み、メインエージェント、そこから起動されたサブエージェント、それぞれが実行するツールをグラフとして表示します。セッションの進行に合わせてグラフも更新されます。完了したセッションは、セッション固有のタイムスタンプに沿って、速度を設定して再生できます。実行中のセッションを追いかけ、成長する様子を見ることもできます。

このツールは読み取り専用で、ネットワーククライアントを依存関係に含まず、すべてローカルで動作します。ネイティブの`zoe`バイナリに加えて、同じエンジンをWebAssemblyにコンパイルしてブラウザ上で実行できます。トランスクリプトはディスクから開くか、ページにドロップして読み込めます。ヘッドレスの`zoe inspect`コマンドを使えば、インターフェースを起動せずにセッションツリーを出力できます。

主な機能

  • 01各エージェント、サブエージェント、ワークフローグループを、ステータスとツール数付きのノードとして表示します。
  • 02ツール呼び出しをエージェントの下にチップ形式で表示し、成功または失敗を示します。
  • 03完了したセッションを再生したり、実行中のセッションを追跡したりできます。スクラブ可能なタイムラインも備えています。
  • 04時間を巻き戻すと、その時点のセッションの状態が正確に復元されます。
  • 05エージェントをクリックすると、起動時のプロンプト、モデル、実行時間付きのツール呼び出しを確認できます。
  • 06ターミナルまたはブラウザで動作し、ヘッドレスのinspectモードも利用できます。

ユースケース

  • 長時間実行されるClaude CodeやCodexのセッションを見て、どのサブエージェントが動作中かを確認する。
  • 完了したエージェントの実行を振り返り、タスクの委譲方法や使用されたツールを把握する。
  • 履歴を任意の時点までたどり、エージェントのワークフローをデバッグする。
  • TTYのないマシンでヘッドレスコマンドを使ってセッションを調べる。

クイックスタート

  1. 1

    Homebrewでインストール

    brew install furkankly/tap/zoetrope
  2. 2

    またはCargoでインストール

    cargo install zoetrope
  3. 3

    起動して、現在のプロジェクトのライブセッションを追跡

    zoe

使う前に知っておきたいこと

  • Claude CodeとCodexの非公開のトランスクリプト形式に依存しており、予告なく変更される可能性があります。
  • 読み取り専用のビューアーです。エージェントのセッションを制御したり実行したりすることはできません。

トピック

よくある質問

zoetrope とは?
Claude CodeとCodexのセッションを、エージェントとツール呼び出しのライブフローグラフとして表示するターミナル/ブラウザ用ビューア。 zoetropeは、Claude CodeとCodexがセッションごとに出力するトランスクリプトファイルを読み込み、メインエージェント、そこから起動されたサブエージェント、それぞれが実行するツールをグラフとして表示します。セッションの進行に合わせてグラフも更新されます。完了したセッションは、セッション固有のタイムスタンプに沿って、速度を設定して再生できます。実行中のセッションを追いかけ、成長する様子を見ることもできます。
zoetrope は無料で使えますか?ライセンスは?
zoetrope は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
zoetrope は今もメンテナンスされていますか?
活発にメンテナンス中。zoetrope の最終コミットは 2026年10月14日 です。
zoetrope は何に使えますか?
長時間実行されるClaude CodeやCodexのセッションを見て、どのサブエージェントが動作中かを確認する。 完了したエージェントの実行を振り返り、タスクの委譲方法や使用されたツールを把握する。 履歴を任意の時点までたどり、エージェントのワークフローをデバッグする。 TTYのないマシンでヘッドレスコマンドを使ってセッションを調べる。
zoetrope のインストール方法は?
Homebrewでインストール: brew install furkankly/tap/zoetrope またはCargoでインストール: cargo install zoetrope 起動して、現在のプロジェクトのライブセッションを追跡: zoe
zoetrope はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/furkankly/zoetrope

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト