simple10/agents-observe

解決的問題

當 AI 代理（例如 Claude Code）自主運行時，其內部流程——例如產生子代理、執行 bash 命令、讀取檔案——通常對使用者是不可見的。這種不透明性使得難以即時了解代理正在執行的動作，或調試並行執行鏈深處發生的失敗。

工作原理

Agents Observe 使用一套鉤子系統，在每個代理事件（工具呼叫、提示詞、子代理生命週期）觸發時進行響應。CLI 工具會捕獲這些事件，並透過 HTTP POST 將其傳送至後端伺服器（在 Docker 中執行），後端伺服器將事件儲存在 SQLite 資料庫中。一個基於 React 的儀表板透過 WebSocket 即時串流這些事件，讓使用者能視覺化代理層級結構、工具使用情況與會話歷史。

適用對象

需要深入洞察 AI 代理自主行為，以進行除錯、監控與分析代理工作流程的 Claude Code 或 Codex 代理使用者。

主要亮點

• 即時監控：即時觀看工具呼叫與代理活動流入儀表板的過程。
• 代理層級結構視覺化：清楚查看哪個父代理產生了哪些子代理。
• Token 與成本追蹤：監控每個會話的 Token 使用量與成本明細。
• 完整事件回放：瀏覽歷史會話，包含完整的載入資料、命令與結果，實現「時間旅行」式除錯。
• 整合插件：可直接作為 Claude Code 插件安裝，支援專用斜線命令（例如 /observe status）進行管理。