Agentbox - コーディングエージェントサンドボックス

エージェントをサンドボックス化する完璧な方法は（まだ）存在しませんが、コンテナは実用的な第一歩です。

Agentbox は Docker ベースのコーディングエージェントサンドボックスで、もともとは Batrachian Toad に触発され、現在ではより多くのツールに一般化されています。 webterm とうまく連携し、複数のエージェントセッションを実行するための分離された環境を提供します。

機能

デフォルトのコンテナは以下を提供します：

• 開発環境: 一般的な開発ツールを備えた Debian Stable
• プリインストールされたコーディングエージェント: Copilot CLI、Codex、Pi
• プリインストールされた CLI ツール: gh、Nushell、lazygit、killall
• パッケージマネージャー: Homebrew と APT、さらに uv と Bun。コンテナビルドでは正確なバージョン固定なしに最新の利用可能なパッケージをインストールします
• オプションのエージェントツール: make -C ~ ... で toad、opencode、gemini、vibe をインストール
• サービス制御: ENABLE_DOCKER、ENABLE_SSH、ENABLE_RDP で Docker/SSH/RDP を切り替え
• Docker-in-Docker: コンテナが特権モードで実行されている場合に利用可能
• リモートアクセス: SSH（ENABLE_SSH=true）と mosh サポート
• ワークスペースブートストラップ: /home/agent/workspace-skel に組み込みのワークスペーススケルトンとエージェントスキル

ロードマップ

• CPU とメモリの制限（基本的な Docker リソース制約）
• ネットワーク分離オプション
• その他のサンドボックス技術（gVisor、Kata Containers など）

サービス設定

Agentbox は環境変数を使用して、コンテナ起動時にどのサービスを開始するかを制御します：

• ENABLE_DOCKER=true - Docker デーモンを起動（Docker-in-Docker サポート用）
• ENABLE_SSH=true - SSH サーバーを起動（ポート 22）
• ENABLE_RDP=true - RDP サーバーを起動（ポート 3389）
• AGENTBOX_ENVIRONMENT=cli|gui - イメージが提供する環境マーカー（cli はヘッドレス/CLI、gui はデスクトップイメージ）

デフォルトの動作: 明示的に有効化されない限り、すべてのサービスは無効です。

例：

# Default - all services disabled
docker run -d agentbox

# Enable only Docker daemon
docker run -d -e ENABLE_DOCKER=true agentbox

# Enable Docker and SSH for development
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -p 22:22 agentbox

# Full desktop experience with all services (GUI image)
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -e ENABLE_RDP=true -p 22:22 -p 3389:3389 agentbox:gui

クイックスタート

オプションのツールインストール

コンテナ内では、agent ユーザーに ~/Makefile が付属しており、追加のツールをインストールできます。

make -C ~ … でインストールできるコーディングエージェント/CLI：

• toad — Batrachian Toad をインストール（uv tool 経由）
• opencode — OpenCode をインストール（Bun 経由）
• gemini — Gemini CLI をインストール（Homebrew 経由）
• vibe — mistral-vibe をインストール（uv tool 経由）

便利なターゲット：

• tools — node、go、gemini、vibe をインストール
• node、go — 言語ツールチェーンをインストール（一部のエージェントの前提条件）

ワークスペーススケルトン

Agentbox には /home/agent/workspace-skel に組み込みのプロジェクトスケルトンが付属しています。

既存のファイルを上書きせずに現在の /workspace にコピーするには：

make init-workspace

詳細は docs/workspace-skeleton.md を参照してください。

GUI イメージ

GUI ビルドは :gui タグ（および <release>-gui）として公開され、XFCE、XRDP、VS Code が含まれています。

Docker Compose

推奨ワークフロー：

make up
make enter-toad   # or: make enter-copilot
make down

サービスのオーバーライドが必要な場合は、docker-compose.override.yml を作成します：

services:
  toad:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"
  copilot:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"

次に実行します：

docker compose up -d

Docker を直接使用する

# Build the headless image
docker build -t agentbox .

# Build the GUI image
docker build -t agentbox:gui --target gui .

# Run the container with selected services (GUI image)
docker run -d \
  --name agentbox \
  --privileged \
  -e ENABLE_DOCKER=true \
  -e ENABLE_SSH=true \
  -e ENABLE_RDP=true \
  -p 22:22 \
  -p 3389:3389 \
  -v $(pwd):/workspace \
  agentbox:gui

Batrachian Toad の使用

コンテナに接続したら：

1. Toad をインストール（必要な場合）：

make -C ~ toad

2. Toad を起動：

toad

3. または特定のプロジェクトディレクトリで起動：

toad /workspace

4. またはエージェントを直接指定して起動：

toad -a open-hands

セキュリティに関する注意

• サービス制御: デフォルトでは、すべてのサービス（Docker、SSH、RDP）は無効です。環境変数を使用して、必要なものだけを明示的に有効化してください。
• デフォルトのパスワードは脆弱です - 本番環境で使用する場合は変更してください
• エージェントが Docker-in-Docker を利用できるようにするには、コンテナを特権モードで実行する必要があります（何もしないよりはマシです）
• パスワード認証の代わりに SSH キーの使用を検討してください
• 本番環境で使用する場合は、不要なサービスを無効化し、デフォルトの認証情報を変更することを検討してください

クレジット

このプロジェクトは、私の古い rcarmo/docker-templates/desktop-chrome をベースに、ユーザーランドを更新したものです。

ライセンス

MIT