インストール

ABG を動かすには、ブラウザー拡張機能、Gateway アプリ、abg CLI の3つを入れます。

必要なもの

現行の Gateway アプリは macOS 14 以降の Apple Silicon 搭載 Mac で動きます。Homebrew の cask と DMG は arm64 専用です。
Chrome 拡張機能には Google Chrome 120 以降が必要です。
abg を実行できるターミナル。
ソースからビルドする場合は Xcode 16 以降、mise、Node.js、pnpm。

macOS: Homebrew

Homebrew は Agent Browser Gateway.app を /Applications に、abg を Homebrew の bin に入れます。

リポジトリを tap し、cask を信頼してからインストールします。

brew tap arcmanagement/agent-browser-gateway https://github.com/arcmanagement/agent-browser-gateway
brew trust --cask arcmanagement/agent-browser-gateway/agent-browser-gateway
brew install --cask agent-browser-gateway

アプリを一度起動し、メニューバーにアイコンを出します。
Terminal window
```
open -a "Agent Browser Gateway"
```
CLI から Gateway に届くか確かめます。
Terminal window
```
abg status
```
JSON の running が true なら接続できています。

更新するときは brew upgrade --cask agent-browser-gateway を実行します。

Homebrew で困ったとき

Not upgrading agent-browser-gateway, the latest version is already installed と出る: cask はインストール済みです。brew info --cask agent-browser-gateway か abg --help で確かめます。入れ直したいときだけ brew reinstall --cask agent-browser-gateway を使います。
他の tap について trust の警告が出る: ABG とは関係のない tap の警告です。ABG の状態は最後の install 行と brew info --cask agent-browser-gateway で確かめます。
以前に別の ABG リポジトリを tap していた: 一時的な公開 Homebrew リポジトリや非公開のソースリポジトリを tap していた場合は、brew untap arcmanagement/agent-browser-gateway を一度実行し、上の URL 付きのコマンドで tap し直します。

macOS: DMG

ダウンロードページか GitHub Releases から、現行の DMG と対応する .sha256.txt ファイルをダウンロードします。
2つのファイルを保存したフォルダーでチェックサムを検証します。
Terminal window
```
shasum -a 256 -c agent-browser-gateway-X.Y.Z-macos-arm64.dmg.sha256.txt
```
X.Y.Z はダウンロードしたバージョンに置き換えます。出力の末尾が OK でなければ、そのファイルはインストールしないでください。
DMG を開き、Install Agent Browser Gateway.app をダブルクリックします。インストーラーはアプリを /Applications にコピーし、abg を /usr/local/bin に入れ、メニューバーのアプリを起動します。
接続を確かめます。
Terminal window
```
abg status
```

更新するときは、新しい DMG をダウンロードしてインストーラーをもう一度実行します。abg が PATH にない場合は、リリース成果物の CLI を配置するか、Homebrew の cask から入れます。

ブラウザー拡張機能

通常は Chrome ウェブストアから Agent Browser Gateway を入れます。公開中のストア掲載は拡張機能 v0.4.8 で、v0.5.2 は審査中です。

シークレットウィンドウで使うには、拡張機能の詳細画面で Allow in incognito をオンにします。Chrome は初期設定では、シークレットウィンドウで拡張機能を動かしません。通常のウィンドウだけで使うなら、この設定は要りません。

ポップアップ、承認ウィンドウ、注釈の画面は、英語か日本語で表示できます。ポップアップの 詳細設定 にある 表示言語 で切り替えます。自動を選ぶとブラウザーの言語に合わせます。abg の出力、エラーコード、監査ログは英語のままです。

拡張機能を開発するときは、展開済みのビルドを読み込みます。ソースからのビルドを参照してください。

エージェントスキルと MCP

Gateway と CLI が動いたら、skills CLI で Claude Code と Codex 向けのスキルを入れるか更新します。

npx skills add arcmanagement/agent-browser-gateway -g

片方のエージェントだけに入れるときは -a claude-code か -a codex を付けます。あとから更新するときは npx skills update -g を実行します。

MCP クライアントからは abg mcp-server を使います。stdio で動く MCP サーバーで、abg_cli というツールを1つだけ公開します。中身は同じローカル CLI を呼ぶだけなので、共有、承認、監査ログの仕組みはそのまま働きます。

Claude Code:

claude mcp add abg -- abg mcp-server

Codex は ~/.codex/config.toml に追加します。

[mcp_servers.abg]
command = "abg"
args = ["mcp-server"]

Windows

Windows 0.5.3 は、Mac アプリと Chrome 拡張機能に合わせた The Gate デザインです。トレイから概要・共有タブ・操作履歴・設定を開けます。タブのコピー／共有解除、履歴の検索、表示モードと言語の切り替えに対応しています。

WinGet でインストールできるようにする予定です。

winget install --id ArcManagement.AgentBrowserGateway --source winget

Windows v0.5.3 のセットアップ ZIPと、同じリリースの .sha256.txt をダウンロードします。チェックサムを確認して ZIP を展開し、AgentBrowserGatewaySetup.exe を実行してください。

ソースからビルドする場合は、Windows 上でリポジトリを clone し、リポジトリのルートで次を実行します。

.\windows-build-install.cmd

ソースからのビルド

Gateway と CLI

mise trust
mise install
./build-app.sh
open "Agent Browser Gateway.app"

./build-app.sh は Agent Browser Gateway.app と .build/release/abg を作ります。

展開済みの拡張機能

cd extension
pnpm install
pnpm run build

Chrome で chrome://extensions を開き、デベロッパーモード をオンにして パッケージ化されていない拡張機能を読み込む を選び、extension/dist/ を指定します。

開発版アプリ

開発版はポート 8766 で動く別のメニューバーアプリです。ローカルの状態も本番とは別に持ちます。

CONFIG=debug APP_VARIANT=dev ./build-app.sh
open "Agent Browser Gateway Dev.app"
ABG_PORT=8766 .build/debug/abg status

本番のユーザープラグインは ~/.abg/plugins/ に置かれます。ABG_PORT=8766 の開発版は ~/.abg-dev/plugins/ を使うため、手元の実験が本番のプラグインの状態を変えません。

次に読む

はじめに: タブを共有して読み取る
配布: リリースの状況と成果物の検証