Browserless

Browserless provides cloud browser infrastructure with a Sessions API. Use it when running agent-browser in environments where a local browser isn't available.

Setup

export BROWSERLESS_API_KEY="your-api-token"
agent-browser -p browserless open https://example.com

Or use environment variables for CI/scripts:

export AGENT_BROWSER_PROVIDER=browserless
export BROWSERLESS_API_KEY="your-api-token"
agent-browser open https://example.com

The -p flag takes precedence over AGENT_BROWSER_PROVIDER.

Configuration

Variable	Description	Default
`BROWSERLESS_API_KEY`	API token (required)
`BROWSERLESS_API_URL`	Base API URL (for custom regions or self-hosted)	`https://production-sfo.browserless.io`
`BROWSERLESS_BROWSER_TYPE`	Type of browser to use (`chromium` or `chrome`)	`chromium`
`BROWSERLESS_TTL`	Session TTL in milliseconds	`300000`
`BROWSERLESS_STEALTH`	Enable stealth mode	`true`

When enabled, agent-browser connects to a Browserless cloud session instead of launching a local browser. All commands work identically.

Get your API token from the Browserless Dashboard.