furkankly/zoetrope

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

它解決的問題

Zoetrope 提供了一種視覺化的方式來監控和審查 AI 代理會話。使用者不再需要閱讀 Claude Code 或 Codex 等工具產生的冗長線性文字轉錄,而是可以將整個流程以即時、互動式的流程圖形式呈現。這讓理解主代理與其產生的子代理之間的關係,以及它們執行工具呼叫的順序變得更容易。

如何運作

Zoetrope 讀取 AI 代理產生的內部轉錄檔案(JSONL)。它將這些轉錄視為僅追加的事件日誌,並解析為代理、提示和工具呼叫的模型。

它提供兩種查看資料的方式:

  • 終端 UI: 使用 Rust 和 Ratatui 建立的原生二進位檔,在終端中渲染圖形。
  • 瀏覽器: 同一引擎的 WebAssembly (WASM) 版本,允許使用者直接將轉錄檔案拖曳至瀏覽器視窗中。

系統使用獨立的「內容時鐘」(基於會話時間戳)和「展示時鐘」(用於動畫),讓使用者可以捲動會話歷史、暫停,或即時追蹤正在運行會話的即時邊緣。

適用對象

希望獲得其代理工作流程高階視覺概覽、能夠「時光旅行」至會話執行過程中的任何時刻,並能檢視每個代理行動背後特定提示與推理的 Claude Code 和 Codex 開發者與高階使用者。

特色

  • 即時流程圖: 將主代理及其產生的子代理以節點形式視覺化,顯示即時狀態與工具活動。
  • 時光旅行: 可拖曳的時間軸讓使用者能向前或向後搜尋,並看到會話在任何時刻的完整狀態。
  • 詳細檢視: 點擊代理可查看其來源,包括觸發提示、推理過程,以及帶有時間戳的具體工具呼叫。
  • 本地優先且私密: 完全在本地機器上運作,無需任何網路依賴,確保轉錄檔從未上傳。
  • 可攜式核心: 單一以 Rust 寫成的引擎,同時支援終端與瀏覽器介面。

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案