agent-browser

library0.26.0jsnpmunverified

agent-browser is a browser automation CLI optimized for AI agents, built in Rust for speed. The current stable version is 0.26.0, with frequent releases (weekly/biweekly). It differentiates from Puppeteer/Playwright by being a native CLI with zero runtime dependencies (no Node.js required for the daemon), supporting headless Chrome via CDP, AI chat commands, and observability dashboard. It offers both accessibility-ref-based and traditional CSS selector interactions, and includes a daemon for persistent sessions.

llm-agents devops testing

npm install agent-browser

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AGENT-BROWSER

agent-browser

llm-agentsjavascriptv0.26.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

agent-browser (CLI)

✓ npm install -g agent-browser or npx agent-browser

✗ const agentBrowser = require('agent-browser')

agent-browser is a CLI tool, not a library. Use as global command or via npx.

agent-browser (npm package)

✓ npm install agent-browser

✗ npm install @vercel/agent-browser

Package name is 'agent-browser', scoped packages are not correct.

Homebrew install

✓ brew install agent-browser

✗ brew install vercel/agent-browser

Homebrew formula is just 'agent-browser'.

Shows global install, Chrome download, navigating to a URL, taking a snapshot, clicking a ref, filling a form, getting text, taking a screenshot, and closing the browser.

npm install -g agent-browser agent-browser install agent-browser open example.com agent-browser snapshot agent-browser click @e2 agent-browser fill @e3 "test@example.com" agent-browser get text @e1 agent-browser screenshot page.png agent-browser close

agent-browser --version

Debug

Known issues

gotchaagent-browser is a CLI tool, not a Node.js library. Do not import it via require/import in JavaScript/TypeScript code. Use child_process.exec or similar to invoke the CLI.

fix

Use execSync or spawn from child_process module to run commands.

affects: >=0.1.0

breakingFrom v0.25.0, the 'chat' command requires AI_GATEWAY_API_KEY environment variable. Missing it will cause an error.

fix

Set AI_GATEWAY_API_KEY or use --key flag with the command.

affects: >=0.25.0

gotchaThe 'install' command downloads Chrome from Chrome for Testing. If you already have Chrome, Brave, etc., it may still download its own executable (~200MB).

fix

Use --no-install or configure to use existing browser via CHROME_PATH environment variable.

affects: >=0.1.0

breakingIn v0.24.0, the 'provider' flag was added for cloud browser providers (e.g., AWS Bedrock AgentCore). Using '--provider' without specifying a valid provider may break existing scripts.

fix

Ensure scripts using --provider are updated to specify the provider name.

affects: >=0.24.0

gotchaThe daemon process may persist after your session ends. Use 'agent-browser stop' to kill it, otherwise it may occupy the port.

fix

Run 'agent-browser stop' or kill the daemon process manually.

affects: >=0.1.0

breakingIn v0.23.4, a fix was applied to prevent daemon hang on Linux due to SIGCHLD race condition. Users on older versions may experience hangs.

fix

Upgrade to v0.23.4 or later.

affects: <0.23.4

deprecatedThe 'dashboard install' command is deprecated as of v0.25.1. The dashboard is now embedded in the CLI binary.

fix

Simply use 'agent-browser dashboard' without prior install.

affects: >=0.25.1

Errors

Common errors & fixes

agent-browser: command not found

The CLI is not installed globally or not in PATH.

fix

Run 'npm install -g agent-browser' and ensure npm global bin directory is in PATH.

Error: Could not find Chrome. Run 'agent-browser install' to download Chrome.

No Chrome installation detected and not yet downloaded via agent-browser.

fix

Run 'agent-browser install' or set the CHROME_PATH environment variable to an existing Chrome/Chromium executable.

Error: AI_GATEWAY_API_KEY is not set

AI chat command requires an API key for the AI Gateway.

fix

Set the AI_GATEWAY_API_KEY environment variable or use --key with the command.

Error: Failed to connect to daemon. Is the daemon running?

agent-browser requires a daemon process to manage browser sessions. It may not be started or has crashed.

fix

Run 'agent-browser daemon' to start the daemon, or use 'agent-browser open' to start automatically.

Upgrade

Version history

0.26.0latest on npm

Audit

Dependencies

chrome-for-testingoptionalDownloads Chrome for Testing during install, required for automation

Agent activity

64 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/vercel-labs/agent-browser ↗

packagehttps://www.npmjs.com/package/agent-browser ↗

homepagehttps://agent-browser.dev ↗