mcpField
W
wsl2-browser-setup

wsl2-browser-setup

github.com/arthurzakirov開発1167 回インストール2 週間前に更新
リポジトリ

wsl2-browser-setup について

wsl2-browser-setupは、WSL2でのブラウザー利用を設定・診断するスキルです。対話的な閲覧や自動化ツールとの接続に向け、WSL内のChrome、Windowsブラウザーブリッジ、任意のagent-browser層を分けて案内します。

主な機能

  1. 01WSL内のChromeを設定
  2. 02Windowsブラウザーブリッジを構成
  3. 03agent-browser層を追加
  4. 04変更を加えないチェックを実行
  5. 05トラブルシューティングを参照

活用シーン

  1. 01WSLで対話的に閲覧・サインイン
  2. 02WSLツールからWindowsのChromeやEdgeを操作
  3. 03既存のブラウザーやブリッジ設定を診断
  4. 04検証済みブラウザーにagent-browserを接続

インストール

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

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

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

同梱ファイル

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

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

詳細

WSL2 ブラウザーのセットアップ

ブラウザーを利用できる状態にするところから、オプションの agent-browser セットアップまで、WSL2 でブラウザーを使う一連の手順にはこのスキルを使用してください。

手順を選ぶ

必要なこと最初に行うこと成功の目安
WSL 内での対話的なブラウジングやサインインWSL ネイティブの ChromeLinux の Chrome で通常の HTTPS サイトと対象のサインインページが表示されます。
WSL のツールから Windows の Chrome または Edge を操作するWindows ホストのブラウザーブリッジWSL からブリッジの /json/version エンドポイントにアクセスできます。
要求されたクライアントが agent-browserどちらかのブラウザー経路を確立してから、クライアント層を追加しますagent-browser が選択したブラウザーを開くか接続し、スナップショットを返します。

適切な手順が不明な場合は、references/architecture.md をお読みください。

WSL ネイティブの Chrome

次を実行します。

bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-native-wsl-chrome.sh"

このスクリプトは WSL2 を確認し、必要に応じて Linux 版の google-chrome をインストールし、標準の Windows .wslconfig ネットワーク設定を書き込み、WSL の再起動が必要かどうかを報告します。

設定を変更した後は、担当者に wsl --shutdown を実行してもらい、WSL を再度開いて google-chrome を起動してください。chrome://settings/security で Use secure DNS を完全にオフにします。OS default (when available) はオフではありません。Chrome を再起動し、通常の HTTPS サイトと実際の対象ページまたはサインインページが表示されることを確認してください。

Windows ホストのブラウザーブリッジ

次を実行します。

bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-windows-host-browser-bridge.sh"

このスクリプトは Windows の Edge または Chrome を検出し、リモートデバッグを有効にして起動します。また、ポートプロキシとファイアウォールルールの設定に Windows の昇格を要求し、CDP エンドポイントが WSL2 からアクセス可能になるまで待機します。汎用ブラウザーエンドポイントを公開しますが、クライアントの接続は別の手順です。

agent-browser

この層を追加するのは、ネイティブの Chrome ブラウジングまたは Windows ブリッジが正常に動作すると確認できた後にしてください。ランタイムのインストール、上流スキルの対話型手順、ネイティブ環境の確認、ブリッジへの接続、互換性ラッパーについては、references/agent-browser.md をお読みください。

安全な確認

既存のセットアップを診断する際は、まず変更を加えない確認を行ってください。

bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-native-wsl-chrome.sh" --check-only
bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-windows-host-browser-bridge.sh" --check-only
bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-agent-browser-runtime.sh" --check-only

詳細なガイダンス

  • ブラウザーは起動するものの、ブラウジング、サインイン、ブリッジへのアクセス、または agent-browser が失敗する場合は、references/troubleshooting.md をお読みください。
  • 低レベルの DNS、ファイアウォール、パッケージ、またはクライアントの回避策を試す前に、references/dead-ends.md をお読みください。
  • 以前のワンショット形式の Windows ブリッジ手順が特に有用な場合に限り、scripts/setup-agent-browser-wsl2.sh を使用してください。

コメント

Markdown 対応