simple10/agents-observe

何を解決するか

AIエージェント（例：Claude Code）が自律的に実行される際、サブエージェントの生成、bashコマンドの実行、ファイルの読み取りなどの内部プロセスはユーザーには見えないことがよくあります。この不透明性により、エージェントがリアルタイムで何をしているかを理解したり、並列実行チェーンの深部で発生した障害をデバッグしたりするのが困難になります。

動作方法

Agents Observeは、エージェントイベント（ツール呼び出し、プロンプト、サブエージェントのライフサイクルなど）ごとにトリガーされるフックシステムを使用しています。CLIツールがこれらのイベントをキャプチャし、HTTP POSTでバックエンドサーバー（Dockerで実行）に送信します。バックエンドはSQLiteデータベースにイベントを保存します。ReactベースのダッシュボードはWebSocket経由でリアルタイムでイベントをストリーミングし、ユーザーがエージェント階層、ツール使用状況、セッション履歴を可視化できるようにします。

対象ユーザー

自律的なAIエージェントの行動を深く可視化してデバッグ、監視、分析が必要なClaude CodeまたはCodexエージェントを使用する開発者。

主な特徴

• リアルタイム監視：ツール呼び出しやエージェント活動がダッシュボードにリアルタイムでストリーミングされるのを確認できます。
• エージェント階層の可視化：どの親エージェントがどのサブエージェントを生成したかを正確に確認できます。
• トークンとコストの追跡：各セッションのトークン使用量とコストの内訳を監視できます。
• 完全なイベントリプレイ：過去のセッションを完全なペイロード、コマンド、結果とともに閲覧でき、「タイムトラベル」デバッグが可能になります。
• 統合プラグイン：Claude Codeプラグインとして直接インストールでき、専用のスラッシュコマンド（例：/observe status）で管理が可能です。