agentbrowser

Installation

Global installation (recommended)

Installs the native Rust binary for maximum performance:

npm install -g agent-browser
agent-browser install  # Download Chrome from Chrome for Testing (first time)

This is the fastest option - commands run through the native Rust CLI directly with sub-millisecond parsing overhead.

Quick start (no install)

npx agent-browser install   # Download Chrome (first time only)
npx agent-browser open example.com

Project installation (local dependency)

For projects that want to pin the version in package.json:

npm install agent-browser
npx agent-browser install  # Download Chrome (first time)

Homebrew (macOS)

brew install agent-browser
agent-browser install  # Download Chrome (first time)

Cargo (Rust)

cargo install agent-browser
agent-browser install  # Download Chrome (first time)

Compiles from source (~2-3 min). Requires Node.js 24+, pnpm 11+, and the Rust toolchain from rustup.rs.

From source

Download the latest release tarball from the changelog page, then build:

tar -xzf agent-browser-latest.tar.gz
cd agent-browser
pnpm install
pnpm build
pnpm build:native
./bin/agent-browser install
pnpm link --global

Linux dependencies

On Linux, install system dependencies:

agent-browser install --with-deps

This exits nonzero if the package manager cannot install every required browser library.

Updating

Upgrade to the latest version:

agent-browser upgrade

Detects your installation method (npm, Homebrew, or Cargo) and runs the appropriate update command automatically.

Doctor

doctor diagnoses your install and auto-cleans stale daemon files:

agent-browser doctor                     # Full diagnosis
agent-browser doctor --offline --quick   # Local-only, fastest (~1s)
agent-browser doctor --fix               # Also run destructive repairs
agent-browser doctor --json              # Structured output

Requirements

  • Chrome - Run agent-browser install to download Chrome from Chrome for Testing.
  • Node.js 24+ and pnpm 11+ - Only needed when building from source.
  • Rust - Only needed when building from source.

Next: Command reference