agent-browser adds cloud browser providers, persistent profiles, remote CDP, downloads, and browser launch flags
Introduced 2026-01-23 · score 0.97
HOW TO USE IT
When repository browser tests need a remote browser, persisted profile, downloads, or custom launch settings, configure `agent-browser` with the documented provider, profile, CDP, download, or launch options.
agent-browser -p browserbase open https://example.com
agent-browser -p browseruse open https://example.com
export AGENT_BROWSER_PROVIDER=browserbase
agent-browser open https://example.comagent-browser --profile <profile-path> open <url>
agent-browser --cdp "wss://<browser-service>/cdp?token=<token>" snapshotagent-browser download @e1 ./file.pdf
agent-browser wait --download ./output.zip --timeout 30000
agent-browser --args "--disable-gpu,--no-sandbox" open <url>
agent-browser --user-agent "<user-agent>" open <url>
agent-browser --proxy-bypass "localhost,*.internal" open <url>WHY THIS HELPS
When testing repository browser behavior with a remote browser, persisted login state, downloads, or custom launch settings, configure agent-browser for the required browser workflow.
REQUIREMENTS AND LIMITATIONS
- Version: v0.7.0
- -p <provider>: Selects a browser provider; documented examples are `browserbase` and `browseruse`.
- AGENT_BROWSER_PROVIDER: Environment variable selecting the browser provider; example value `browserbase`.
- --profile <path>: Persistent browser profile directory; the release note says it stores cookies, localStorage, and login sessions across browser restarts.
- --cdp <port|url>: Connects through CDP; accepts a remote WebSocket URL.
- download <ref> <path> (required): Triggers a download for the referenced element and saves to the supplied path.
- wait --download <path> (required): Waits for a file download at the supplied path; release example also uses `--timeout 30000`.
- --args <args>: Sets browser launch arguments; comma-separated in the documented CLI example.
- --user-agent <ua>: Sets the custom User-Agent string.
- --proxy-bypass <hosts>: Sets hosts to bypass the proxy.
- Cloud browser providers named are Browserbase and Browser Use.
- Persistent profiles store cookies, localStorage, and login sessions across browser restarts.
- Download handling includes ref support.
FIRST-PARTY EVIDENCE
- https://github.com/vercel-labs/agent-browser/releases/tag/v0.7.0
- https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/changelog/page.mdx
- https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/commands.md
Check the installed version and the source before using it. Entry JSON