設定

毎回のコマンドでフラグを繰り返し指定する代わりに、永続的なデフォルト値を設定するために agent-browser.json ファイルを作成してください。

設定ファイルの場所

agent-browser は2つの場所をチェックし、優先度順にマージします：

プロジェクト単位の値がユーザー単位の値を上書きします。環境変数が両方を上書きします。CLIフラグは常に優先されます。

デフォルトの場所ではなく、特定の設定ファイルを読み込むには --config <path> オプションまたは AGENT_BROWSER_CONFIG 環境変数を使用してください：

agent-browser --config ./ci-config.json open example.com
AGENT_BROWSER_CONFIG=./ci-config.json agent-browser open example.com

例：設定ファイル

{
  "headed": true,
  "proxy": "http://localhost:8080",
  "profile": "./browser-data",
  "userAgent": "my-agent/1.0",
  "ignoreHttpsErrors": true
}

全てのオプション

すべての CLI フラグは、そのケメルケース形式を使って設定ファイルで指定できます：

一般的な設定例

ローカル開発

{
  "headed": true,
  "profile": "./browser-data"
}

プロキシの背後にある状況

{
  "proxy": "http://proxy.corp.example.com:8080",
  "proxyBypass": "localhost,*.internal.com",
  "ignoreHttpsErrors": true
}

CI / Devcontainer

{
  "args": "--no-sandbox,--disable-gpu",
  "ignoreHttpsErrors": true
}

iOSテスト

{
  "provider": "ios",
  "device": "iPhone 16 Pro"
}

AIエージェントのセキュリティ

{
  "contentBoundaries": true,
  "maxOutput": 50000,
  "allowedDomains": ["your-app.com", "*.your-app.com"],
  "actionPolicy": "./policy.json"
}

ブール型オプションの上書き

ブール型のフラグは、オプションで true/false 値を指定することで設定値を上書きできます：

agent-browser --headed false open example.com

フラグをそのまま使用した場合（裸のフラグ）は、true を指定したのと同じです：

agent-browser --headed open example.com       # --headed true と同じ
agent-browser --headed true open example.com  # 明示的

このルールはすべてのブール型フラグに適用されます：--headed, --debug, --json, --ignore-https-errors, --allow-file-access, --auto-connect, --content-boundaries, --confirm-interactive, --native。

拡張機能のマージ

ユーザーレベルとプロジェクトレベルの設定から得られる拡張機能は、置換ではなく連結されます。たとえば、~/.agent-browser/config.json が ["/ext1"] と指定し、./agent-browser.json が ["/ext2"] と指定している場合、結果は ["/ext1", "/ext2"] になります。

AGENT_BROWSER_EXTENSIONS 環境変数および CLI の --extension フラグは、標準の優先度ルールに従います（環境変数が設定を上書きし、CLI は末尾に追加）。

環境変数

これらの環境変数は、追加のデーモンおよびランタイム動作を構成します：

エラー処理

• 自動検出された設定ファイル（~/.agent-browser/config.json、./agent-browser.json）が存在しない場合、静かに無視されます。
• --config <path> でファイルが存在しないか不正な形式の場合、エラーで終了します。
• 自動検出されたファイル内の不正なJSON は標準エラー出力に警告を出力し、そのファイルは無視して継続します。
• 不明なキー は前向き互換性のために静かに無視されます。

ヒント: プロジェクトレベルの agent-browser.json に環境依存の値（パス、プロキシなど）が含まれている場合、.gitignore に追加することを検討してください。