Reference
Configuration is environment-driven and local.
| Name | Default | Purpose |
|---|---|---|
BROWSER_AGENT_HOME | ~/.browser-agent | Home directory for browser state, sessions, leases, and traces. |
CDP_PORT | 9222 | Chrome DevTools Protocol port. |
AGBROWSE_JSON_ERRORS | unset | Set to 1 to force JSON error envelopes regardless of --json. |
AGBROWSE_UPDATE_CHECK | enabled outside CI | Set 0 to hide npm update notices, 1 to force the check. |
AGBROWSE_UPDATE_CHECK_TTL | 24h | Cache TTL for npm latest-version checks. |
AGBROWSE_UPDATE_CHECK_LATEST | unset | Override latest version for tests/diagnosis. |
AGBROWSE_WEB_AI_AUTO_START | enabled | Set to 0 to fail when Chrome is not running instead of auto-starting. |
AGBROWSE_PROVIDER_POOL_MAX_PER_KEY | unset | Override warm provider tab pool size per key. |
CHROME_HEADLESS | unset | Set 1 for headless startup. |
CHROME_NO_SANDBOX | unset | Set 1 only in Docker/CI if needed. |
CHROME_BINARY_PATH | auto-detect | Custom Chrome executable path. |
BROWSER_SCRIPT | bundled | Custom browser script path (used by vision-click). |
Local-first boundary
agbrowse stores operational state on the local machine. It does not add hosted model routing, provider API-key auth, or cloud browser execution.