← プロジェクト一覧に戻る

numbat

AIエージェントの活動を端末側でNDJSONに記録し、ローカルのCELルールで検知、対応フックがあれば実行前に遮断する単一バイナリ

公式Apache-2.0
スター
1.1k
フォーク
123
オープンIssue
16
最終コミット
2026年10月30日

numbatとは

デスクトップ・CLI・IDE・ゲートウェイの各エージェントの動きをhookやplugin、OTLP/HTTPのログエクスポータ経由で取り込み、単一のイベントモデルへ正規化したうえでローカルのCELルールで評価し、events・findings・enforcement決定をバージョン付きNDJSONとして書き出します。`numbat scan`はディスク上のセッション成果物を読むため、事前に計装していなかった過去の作業も後から再構成できます。一方で遮断は保守的な設計で、enforceモードは既定で無効、同梱ルールはすべて監視専用なので、実際に止めるにはルールYAMLを運用側のディレクトリへ複製し、idを保ったままenforce: trueを追加してversionを上げる手順が必要です。観測できる範囲はエージェントとサーフェスごとにcoverage matrixで決まり、永続化されなかった活動は後から復元できず、findingsは実行された事実の証明ではなくルールの一致にすぎません。網羅的な記録や確定的な事実認定を期待する用途には向きません。

numbatで何ができますか?

  • 設定を変えずに現状を把握する — numbat agentsで検出済みエージェントを一覧し、numbat scan --agent codexのようにディスク上のセッション成果物を読み取り専用で解析します。hookの導入もエージェント設定の書き換えも発生しません。
  • ライブ監視をエージェント単位で入れる — numbat hook install --agent codex --emit allでhookを入れると、events・findings・indicators・enforcement決定が~/.numbat/records.ndjsonへ追記されます。numbat hook statusが確認するのは設定であって、実行や配送の成否ではありません。
  • CELルールを書いて検証する — YAMLで書いた独自ルールはnumbat rules check --rules-dir ./numbat-policyとnumbat rules testで検証でき、idが一致すれば同梱ルールを置き換えます。--no-builtin-rulesを付けると運用側のカタログだけで動作します。
  • 監視ルールを遮断に切り替える — rules/のYAMLを複製してidを保ったままenforce: trueを追加しversionを上げ、numbat hook install --agent codex --rules-dir ./numbat-policy --enforceで導入します。遮断できるのは同期的な実行前フックを持つエージェントに限られます。
  • 調査結果をまとめて渡す — numbat timelineでセッション単位の時系列を組み立て、numbat case buildとnumbat case verifyがSHA-256マニフェスト付きのケースバンドルを生成・検証します。マニフェストが示すのは内部整合性までで、署名のないバンドルは出所や完全性を保証しません。生トランスクリプト全文は通常の出力に含まれず、証跡ファイルの同梱は明示的なオプトインになります。

スター推移

8月16日〜10月30日 · +224

9251.1k

よくある質問

numbatは商用利用できますか?

numbatはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

numbatはどの形で使えますか?

numbatはローカル実行・セルフホストの形で利用できます。