Repolode
perplexityai

perplexityai/numbat

ローカル検知、任意の実行前ブロック、セッションアーティファクトからのフォレンジック再構成により、AIエージェントのアクティビティをエンドポイント上で可視化します。

スター
1,162
フォーク
125
未解決の Issue
14
最終コミット
4 日前

これは何?

numbatは、ローカルフックやプラグイン、OTLP/HTTPログエクスポーター、ディスク上のセッションアーティファクトを通じて、対応するデスクトップ、CLI、IDE、ゲートウェイのエージェントを監視します。実行中および保存済みのアクティビティを単一のイベントモデルに正規化し、同じCELルールエンジンで評価します。検知はローカルで実行されます。記録は標準出力またはローカルファイルに書き込め、任意でHTTP経由で送信することもできます。

ブロック機能はデフォルトで無効で、対応する同期型の実行前フックと、強制適用対象として明示されたルールにのみ適用されます。付属するルールはすべて監視専用のため、運用者自身がルールをコピーし、enforceフラグを設定して、そのポリシーをインストールする必要があります。フォレンジック再構成は事前の計測なしで対応するセッションアーティファクトから実行でき、読み取り専用スキャンでは出力内のシークレットがマスキングされます。

このプロジェクトは、macOS、Linux、Windows向けにcgoなしでビルドされた単一バイナリとして提供されます。インベントリ、セッションごとのタイムライン、SHA-256マニフェスト付きのポータブルなケースバンドルも備えています。

主な機能

  • 01フック、プラグイン、OTLP/HTTPログエクスポーターを使ったリアルタイム監視。
  • 02組み込みのCELルール、複数ステップのシーケンスルール、カスタムYAMLルールによるローカル検知。
  • 03対応する実行前フックでのオプトイン方式のブロック。デフォルトでは無効です。
  • 04対応するディスク上のセッションアーティファクトからのフォレンジック再構成。
  • 05ワイヤーフォーマット用のJSON Schemaを備えた、バージョン管理されたNDJSON記録。
  • 06シークレットをマスキングする読み取り専用のアーティファクトスキャン。
  • 07SHA-256マニフェスト付きのポータブルなケースバンドル。

ユースケース

  • 開発者のワークステーション上で、コーディングエージェントが何を読み、書き、実行したかを監視する。
  • ディスク上のアーティファクトをもとに、エージェントのセッションを事後調査する。
  • ポリシーを慎重に設定したうえで、SSHのauthorized_keysへの書き込みなど、リスクの高い特定の操作をブロックする。
  • 検証可能なケースバンドルとして、インシデントの証拠を共有する。

クイックスタート

  1. 1

    Go 1.26.9 以降で numbat をインストールする

    go install github.com/perplexityai/numbat/cmd/numbat@latest
  2. 2

    検出されたエージェントを一覧表示し、そのアーティファクトをスキャンする(読み取り専用)

    numbat agents
  3. 3

    Codex 用のライブ監視フックをインストールする(デフォルトは監視のみ)

    numbat hook install --agent codex --emit all

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

  • ライブ監視の対象範囲はエージェントや対象面によって異なるため、利用を前提とする前にカバレッジマトリクスを確認してください。
  • ブロッキングはデフォルトで無効で、同梱ルールはすべて監視のみです。強制適用するには、独自のルールを作成して維持する必要があります。
  • フックはインストール後およびアップグレード後にホスト側で信頼性の確認が必要となり、運用上の手順が増えます。

収録されている特集

トピック

よくある質問

numbat とは?
ローカル検知、任意の実行前ブロック、セッションアーティファクトからのフォレンジック再構成により、AIエージェントのアクティビティをエンドポイント上で可視化します。 numbatは、ローカルフックやプラグイン、OTLP/HTTPログエクスポーター、ディスク上のセッションアーティファクトを通じて、対応するデスクトップ、CLI、IDE、ゲートウェイのエージェントを監視します。実行中および保存済みのアクティビティを単一のイベントモデルに正規化し、同じCELルールエンジンで評価します。検知はローカルで実行されます。記録は標準出力またはローカルファイルに書き込め、任意でHTTP経由で送信することもできます。
numbat は無料で使えますか?ライセンスは?
numbat は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
numbat は今もメンテナンスされていますか?
活発にメンテナンス中。numbat の最終コミットは 2026年11月4日 です。
numbat は何に使えますか?
開発者のワークステーション上で、コーディングエージェントが何を読み、書き、実行したかを監視する。 ディスク上のアーティファクトをもとに、エージェントのセッションを事後調査する。 ポリシーを慎重に設定したうえで、SSHのauthorized_keysへの書き込みなど、リスクの高い特定の操作をブロックする。 検証可能なケースバンドルとして、インシデントの証拠を共有する。
numbat のインストール方法は?
Go 1.26.9 以降で numbat をインストールする: go install github.com/perplexityai/numbat/cmd/numbat@latest 検出されたエージェントを一覧表示し、そのアーティファクトをスキャンする(読み取り専用): numbat agents Codex 用のライブ監視フックをインストールする(デフォルトは監視のみ): numbat hook install --agent codex --emit all
numbat はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/perplexityai/numbat

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

関連プロジェクト

エージェントとネットワークの間に置いて、秘密情報の流出、プロンプトインジェクション、SSRF、MCPツール汚染を防ぎ、署名付きアクションレシートを発行するオープンソースのAIエージェント向けファイアウォール。

987+11 今週113GoApache-2.0活発にメンテナンス更新 2 時間前