Show HN: Lookspan – AIエージェント向けローカルファーストの可観測性ツール（npx lookspan）

Lookspanは、AIエージェントのためのローカルファースト可観測性ツールです。開発者は軽量なダッシュボードでエージェントの各呼び出しを監視でき、すべてのデータはローカルのSQLiteデータベースに保存されます。クラウドサービスに依存しないため、データプライバシーを重視するチームや完全にオフラインで作業したい場合に特に有用です。

このプロジェクトのコアはシンプルながら強力なアーキテクチャです。AIエージェントはHTTPまたはMCPプロトコルを介してトレースデータをローカルサーバーに送信し、サーバーはそのデータをSQLiteに保存し、リアルタイムストリーミングエンドポイントを介してダッシュボードにプッシュします。LookspanはMCP、LangGraph、CrewAI、OpenTelemetryなど複数のフレームワークをサポートしており、既存のAIワークフローに簡単に統合できます。

主な機能は次のとおりです：

• リアルタイムトレース：SSEエンドポイントを介してエージェントのアクティビティをリアルタイムで表示。
• コスト追跡：各LLM呼び出しのコストを自動計算し、カスタム価格設定も可能。
• アラートシステム：エージェントの失敗やコスト/トークン/期間のしきい値を超えた場合に通知。
• リプレイと評価：任意のトレースのプロンプトを再実行し、異なるモデルの出力やコストを比較。
• データセットと実験：テストセットを構築し、モデルをバッチ実行して結果を自動評価。

インストールと起動は非常に簡単で、次の一行コマンドで完了します：

npx lookspan

その後、http://127.0.0.1:3100 を開くとダッシュボードが表示されます。cURLなどのHTTPクライアントでトレースデータを送信すれば、リアルタイムで確認できます。

開発者向けに、Lookspanは複数のSDKを提供しています。TypeScriptでは、@lookspan/openaiや@lookspan/anthropicなどのアダプターを使用して、コードを一行追加するだけでトレースを開始できます。Pythonユーザー向けにはlookspan、lookspan-langgraph、lookspan-crewaiパッケージが用意されています。また、ネイティブのOpenTelemetryプロトコルもサポートしているため、既存のOpenTelemetryコレクターから直接データを送信できます。

セキュリティ面では、Lookspanはデフォルトで127.0.0.1にバインドされ、オプションのトークン認証をサポートしています。サーバー側では、authorization、api_key、tokenなどの資格情報フィールドが自動的に編集されるため、センシティブな情報がデータベースに永続化されることはありません。

他の可観測性プラットフォームと比較して、Lookspanはゼロセットアップの体験とローカルデータファーストのアプローチに重点を置いています。DockerやPostgreSQL、ClickHouseは不要で、すべてのデータはSQLiteに保存されるため、個人開発者や小規模チームに最適です。完全なプラットフォーム機能が必要な場合は、LangfuseやPhoenixの方が適しているかもしれません。しかし、LookspanはTypeScript/MCPエコシステムへのシームレスな統合という独自の強みを持っています。

まとめると、LookspanはAIエージェントのデバッグと監視のための軽量でローカルファーストのソリューションであり、特に開発中にエージェントの動作に関する迅速なフィードバックを得たい開発者に適しています。