superhq-ai/shuru

解決する課題

Shuruは、AIエージェントがホストマシンのセキュリティや安定性を損なうことなく、コードの実行、パッケージのインストール、ツールの使用を行える安全で隔離された環境を提供します。実行のたびにリセットされる使い捨てのmicroVMを提供することで、ローカルシステムを「汚す」という問題を解決します。

仕組み

macOSではAppleのVirtualization.framework、Linux (ARM64)ではKVMバックエンドを使用して軽量なLinux VMを起動します。ゲスト側の書き込みにはtmpfsオーバーレイ層を使用するため、デフォルトではホスト側は一切変更されません。また、ディレクトリマウント用にVirtioFSをサポートしています。シークレット管理用のプロキシが含まれており、実際のAPIキーがVMゲスト内に渡されることはありません。

対象ユーザー

Claude Code、Cursor、Copilotなどのツールを使用してAIエージェントを構築しており、制御された環境で安全かつプログラム的にコードを実行させる必要がある開発者。

主な特徴

• エフェメラルサンドボックス (Ephemeral Sandboxes): 実行のたびに使い捨てられ、ルートファイルシステムは自動的にリセットされます。
• チェックポイント (Checkpoints): ディスク状態を保存・再利用することで、毎回依存関係を再インストールする手間を省きます。
• 安全なシークレット管理 (Secure Secrets): APIキーはHTTPSリクエスト時にプロキシによって置換され、実際のキーはホスト側に保持されます。
• ネットワーク制御 (Network Control): ホスト固有の許可リストを含む、ネットワークアクセスに対するきめ細かな制御。
• TypeScript SDK: Node.js/Bunパッケージを介したサンドボックスのプログラム制御。
• ポートフォワーディング (Port Forwarding): 完全なネットワークアクセスを必要とせずに、vsock経由でゲストサービスをホストに公開します。