agent-workspace-linux は何をしますか？
AIエージェント向けの分離されたLinuxデスクトップワークスペース — MCP経由で隠されたエージェント専用のデスクトップとブラウザを提供し、エージェントが実際のデスクトップに触れずにGUIやWeb作業を行えるようにします。
概要
agent-sh/agent-workspace-linux は、AIエージェント（例：Claude Code、Cursor、Codex）がホストシステムから独立したLinuxデスクトップ環境で動作するためのツールです。このワークスペースは完全に分離されており、エージェントはGUIアプリケーションの実行、Webブラウジング、ファイル操作などを、ユーザーの実際のデスクトップに影響を与えずに行えます。
主な機能
- 分離されたデスクトップ: エージェント専用の仮想デスクトップ環境
- 内蔵ブラウザ: MCP経由でアクセス可能なエージェント制御のブラウザ
- GUI操作: エージェントによるマウス、キーボード、ウィンドウ操作
- ファイルシステム分離: ホストOSから独立したファイル構造
- 簡単構成: 環境変数または設定ファイルでセットアップ可能
使い方
インストール
# リポジトリをクローン
curl -fsSL https://raw.githubusercontent.com/agent-sh/agent-workspace-linux/main/setup.sh | bash
設定
環境変数または agent-workspace-linux.json ファイルで設定します：
{
"workspacePath": "/path/to/workspace",
"displayNumber": 99,
"resolution": "1280x720"
}
起動
./start-workspace.sh
ワークスペースが起動したら、MCPクライアント経由でエージェントが接続します。
プロンプト例
ワークスペース内でFirefoxを開いて、https://example.com にアクセスしてください。
ワークスペースでターミナルを開き、`ls -la` を実行してファイル一覧を表示してください。
トラブルシューティング
- ディスプレイが表示されない:
DISPLAY環境変数が正しく設定されているか確認してください。 - ブラウザが起動しない: 必要な依存パッケージ（firefox, xvfb）がインストールされているか確認してください。
- MCP接続エラー: ワークスペースが起動済みで、正しいポートで待機しているか確認してください。
詳細情報
詳細なドキュメントについては、リポジトリ を参照してください。