mcpField
A
agent-browser-wsl2-setup

agent-browser-wsl2-setup

github.com/arthurzakirovエージェントワークフロー1162 回インストール2 週間前に更新
リポジトリ

agent-browser-wsl2-setup について

WSL2でagent-browserを使うためのセットアップスキルで、インストールとランタイム設定を扱います。ネイティブLinux ChromeとWindowsホストのブラウザブリッジを区別し、それぞれの手順を示します。

主な機能

  1. 01agent-browserとランタイムのインストール
  2. 02ランタイム設定スクリプトの実行
  3. 03WSL2のネイティブChromeで閲覧テスト
  4. 04Windowsブラウザブリッジへの接続
  5. 05トラブルシューティングと構成資料

活用シーン

  1. 01新しいWSL2環境でのagent-browser準備
  2. 02ネイティブLinux Chromeでの閲覧テスト
  3. 03agent-browserとWindowsブラウザの接続
  4. 04agent-browserの設定障害の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill agent-browser-wsl2-setup

インストール後、Claude Code で/agent-browser-wsl2-setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
architecture.md
dead-ends.md
troubleshooting.md
scripts/
connect-windows-browser.sh
ensure-wslconfig.ps1
setup-agent-browser-runtime.sh
setup-agent-browser-wsl2.sh
setup-native-wsl-chrome.sh

詳細

Agent Browser WSL2 のセットアップ

このスキルでは、agent-browser のセットアップのみを扱います。

ブラウザーの利用可否は $wsl2-browser-setup で扱います。次のどちらも満たされていない場合は、まずそのスキルを使用してください。

  • WSL2 内のネイティブ Linux google-chrome で、実際のブラウジングとサインインができる
  • WSL2 から /json/version で Windows ホストのブラウザーブリッジに接続できる

ブートストラップの分担

新しいマシンでは、AI から次の 2 つのコマンドを直接実行します。

npm install -g agent-browser
agent-browser install

次に、ユーザーに次の対話型コマンドを実行してもらいます。

npx skills add vercel-labs/agent-browser

重要：

  • npm install -g agent-browser は非対話型なので、可能であれば AI が実行してください
  • agent-browser install は非対話型なので、可能であれば AI が実行してください
  • npx skills add vercel-labs/agent-browser は対話型なので、ユーザーが実行してください

ユーザーが対話型の npx skills add ... の手順を終えたら、ランタイムのセットアップスクリプトを実行します。

ランタイムのセットアップ

次を実行します。

bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/setup-agent-browser-runtime.sh"

このスクリプトは次の処理を行います。

  • agent-browser が見つからない場合はインストールします
  • 必要に応じて agent-browser install を実行します
  • vercel-labs/agent-browser が見つからない場合はクローンします

モード A：ネイティブ WSL ブラウザー

$wsl2-browser-setup のブラウザーパスが WSL2 内のネイティブ Linux Chrome を指している場合は、agent-browser を直接テストします。

agent-browser doctor --offline --quick
agent-browser open https://example.com
agent-browser snapshot -i -c

手動でのブラウジングは機能するのに、これでもハングする場合は、ここでブラウザーのデバッグを中止し、モード B を使用してください。

モード B：Windows ホストのブラウザーブリッジ

$wsl2-browser-setup のブラウザーパスが Windows ホストのブラウザーブリッジを指している場合は、agent-browser を既存の CDP エンドポイントに接続します。

bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/connect-windows-browser.sh" --session windows-host --bridge-port 9333
agent-browser --session windows-host get title
agent-browser --session windows-host snapshot -i -c

ネイティブブラウザーのパスを整理する前に、動作が確認されていた制御経路です。

従来の統合ラッパー

scripts/setup-agent-browser-wsl2.sh は、以前の Windows ブリッジによる一括セットアップフローとの互換性のために、引き続き存在します。

代わりに、次の分割されたスキルを使用してください。

  1. $wsl2-browser-setup
  2. $agent-browser-wsl2-setup

バンドルされているリソース

コメント

Markdown 対応