SuperHQ

SuperHQとは？

SuperHQは、AIコーディングエージェントを分離された「本物のサンドボックス」内で実行し、エージェントがローカルマシンに直接影響を与えずに制御された環境で作業できるようにします。Claude Code、OpenAI Codex、カスタムエージェントをそれぞれ独自のmicroVMでオーケストレーションします。

主な目的は、エージェント駆動のコード変更を安全に実行することです。プロジェクトがサンドボックス（/workspace）にマウントされ、変更が承認されるまでオーバーレイにキャプチャされ、何かがローカルファイルに触れる前に統一diffを確認できます。

主な機能

• エージェントごとのmicroVM分離: Claude Code、Codex、カスタムエージェントそれぞれが独自のmicroVMで実行され、ワークスペースを封じ込めます。
• Debian VMによる完全なLinuxユーザーランド: サンドボックスはaptなどのパッケージツール、npm、pipを備えたDebian VMとして記述され、エージェントが依存関係をインストール・実行できる環境を提供します。
• /workspaceにマウントされたプロジェクトワークスペース: プロジェクトがサンドボックスにマウントされ、エージェントの編集はこのマウントパスを対象とします。
• 承認ゲート付きオーバーレイ変更: VMで行われた変更はレビュー画面で承認されるまでオーバーレイに留まります。
• ローカル適用前の統一diffレビュー: エージェントの変更に対する統一diffを確認し、保持するか破棄するかを選択できます。
• オプトイン・ポートフォワーディング: 開発サーバー、データベース、APIなどに便利な場合にのみ、サンドボックスからホストへのポートフォワーディングを有効化します。
• チェックポイントと巻き戻し: VM状態を停止・チェックポイントし、後で再開可能。またチェックポイントをフォークして新しいブランチを作成できます。

SuperHQの使い方

1. SuperHQをインストール: macOSで提供されたHomebrewコマンド（brew tap superhq-ai/tap、brew install --cask superhq）を使用。
2. プロジェクト用の新しいワークスペースを作成: UIでワークスペース作成とキーボードショートカットによる素早い切り替えが可能です。
3. エージェントを起動: インターフェースからClaude Code、OpenAI Codex、カスタムエージェントを選択し、サンドボックス内でコーディングタスクを実行。
4. レビュー画面で変更を確認: 統一diffを検査し、ローカルファイルに適用前に承認または破棄。
5. 必要に応じてサンドボックス制御を使用: VM内で実行中のサービスにアクセスする場合にのみポートフォワーディングを有効化し、チェックポイントで一時停止/再開やクリーンなブランチフォークを実行。

ユースケース

• ローカルリポの安全なエージェント駆動リファクタ: 分離されたDebian VMでエージェントを実行しコードを変更、統一diffを確認し、ローカルプロジェクトに適用したい部分のみ承認。
• マシンを汚さずに依存関係の重いタスク: ホストに直接パッケージをインストールせず、サンドボックスのDebianユーザーランド（apt、npm、pip）でエージェントがツールをインストール・実行。
• 一時的な開発サーバーを使ったデバッグ: サンドボックス内で動作するサービス（例: 開発サーバーやAPI）にアクセスするため、オプトインポートフォワーディングを有効化し動作を確認。
• チェックポイントを使った反復実験: ワークスペース状態をチェックポイントし、アプローチを試した後、巻き戻しやフォークで新しい方向性のブランチを作成。
• カスタムエージェントを使ったカスタムワークフロー実行: Claude CodeやCodexを超えるエージェントセットアップの場合、「カスタムエージェント」オプションを使用しつつ、エージェントごとのmicroVMサンドボックス内で実行。

FAQ

• SuperHQは何を分離する？ 各エージェント実行（Claude Code、Codex、カスタムエージェント）は独自のmicroVMサンドボックスで実行されます。

• エージェント実行中にプロジェクトはどこにある？ プロジェクトはサンドボックス内の/workspaceにマウントされます。

• 変更はどうやってローカルファイルに適用される？ エージェントの編集はレビュー画面で承認されるまでオーバーレイに保持。統一diffが表示され、ローカルファイルに触れる前に保持/破棄を選択可能。

• サンドボックスはホストにサービスを公開できる？ はい。ただしポートフォワーディングはオプトインで、サンドボックスからホストへポートを公開する場合にのみ有効化。

• チェックポイントはどう機能する？ ワークスペースを停止し完全なVM状態をチェックポイント、後で数秒で再開、チェックポイントをフォークして新しいブランチを開始可能。

代替案

• ローカルエージェントワークフロー（エージェントを直接マシン上で実行）：シンプルですが、記述されたmicroVM分離、承認ゲーティング、サンドボックスオーバーレイモデルが一般に欠如。
• コンテナ化開発環境（例：Dockerベースのエージェントセットアップ）：コンテナは依存関係とツールを分離可能ですが、特定のオーバーレイ承認フローやmicroVMのチェックポイント/巻き戻し動作は異なる場合あり。
• リモートサンドボックスまたはホスト型コード実行プラットフォーム：分離を提供可能ですが、ワークフローやコード変更のレビュー/適用場所はSuperHQの/workspaceローカルプロジェクトマウントと統一差分承認から異なる場合あり。
• サンドボックスなしのIDE統合AIコーディングアシスタント：エディタ内コーディング支援に焦点；エージェントごとのVM分離、ローカルファイル適用前の差分レビュー、サンドボックスランタイム連動のオプトインポートフォワーディングを提供しない場合あり。