canyonroad/agentsh

Execution-Layer Security (ELS) for AI agents — policy-enforced shell with audit.

What it solves

従来の AI エージェント向けセキュリティ制御はツールの境界で止まっており、コマンド内部(pip installpython script.py など)やそのサブプロセスで何が起きているかを見たり制御したりできません。agentsh は安全な実行ゲートウェイを提供し、実行時にファイル、ネットワーク、プロセス、シグナルのアクティビティをインターセプトしてポリシーを適用し、サブプロセスが行う隠れた作業さえも統治・監査します。

How it works

agentsh はエージェントのツールチェーンの下に配置できるシェル/exec エンドポイントとして機能します。システムレベルのイベントをインターセプトし、ポリシーエンジンに渡します。ポリシーエンジンは allowdenyapprove(人間の介入が必要)、audit(ログ)、soft_delete(隔離)、redirect(安全な代替コマンドやパスに置き換える)を実行できます。

主な技術コンポーネントは次のとおりです:

  • Runtime Enforcement:seccomp、Landlock、eBPF、FUSE などのシステムレベルプリミティブを使用してアクティビティを監視・制御します。
  • I/O Visibility:ファイル操作、DNS/ネットワーク接続、PTY アクティビティ、プロセスライフサイクルを追跡します。
  • Specialized Proxies:ステートメント単位の SQL ポリシー適用のための組み込み PostgreSQL プロキシと、DLP マスクと API リクエストの使用量追跡を行う LLM プロキシを含みます。
  • Shell Shim:コンテナにインストールして、すべてのシェルアクティビティをポリシーエンジンへルーティングできます。

Who it’s for

セキュリティ、監査性、厳格なランタイム制御が求められる環境で、任意のコードを実行する必要がある AI エージェントをデプロイする開発者や運用者向けです。特に CI/CD パイプラインやサンドボックス化されたコンテナ環境で有用です。

Highlights

  • Steering via Redirection:単にアクションを拒否するだけでなく、エージェントを安全なコマンドや作業ディレクトリにリダイレクトし、正しい振る舞いへ導きます。
  • Deep Visibility:サブプロセスからのものも含め、すべてのファイル、ネットワーク、プロセス操作について構造化された監査イベントを取得します。
  • DLP and LLM Proxy:LLM API 呼び出しをインターセプトし、PII をマスクし、リクエストがプロバイダーに届く前にトークン使用量を追跡します。
  • Database Governance:PostgreSQL データベースに対し、ステートメント単位の細かいアクセス制御を提供します。
  • Workspace Checkpoints:破壊的なエージェント操作から回復できるよう、ワークスペースのスナップショット作成を可能にします。
  • Profile-then-Lock:セッションの振る舞いを観察して制限的なポリシーを自動生成し、将来の実行を観測されたパターンにロックします。