install

Additional install commands

macOS

Homebrewverified · 100%

brew install agent-browser

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#agent-browser

nixpkgs package indexes · pkgs/by-name/ag/agent-browser/package.nix · source: api.github.com

Windows

Scoopverified · 92%

scoop install main/agent-browser

Scoop official bucket manifest trees · bucket/agent-browser.json · source: api.github.com

overview

Package summary

Browser automation CLI for AI agents

Project links

Commands and aliases

agent-browser

history

Project history and usage

agent-browser is a Vercel Labs browser automation CLI for AI agents, packaged as a fast native Rust binary with command-line, docs-site, and MCP-oriented workflows.

Project history

The GitHub repository was created in January 2026. The README describes agent-browser as a browser automation CLI for AI agents and a fast native Rust CLI. It provides browser operations such as open, snapshot, click, fill, screenshot, PDF, JavaScript evaluation, and agent-readable text extraction.

The project moved quickly through many 0.x releases in 2026. The changelog shows a shift from basic browser control toward agent-oriented ergonomics: config schemas, doctor diagnostics, stable tab IDs, React and Web Vitals introspection, an MCP server, plugin support, read commands, and restore workflows.

Adoption history

The README documents installation through npm, Homebrew, Cargo, and source builds, with Chrome for Testing as the recommended browser channel. The supplied package metadata records Homebrew, Nix, and Scoop packaging, which matches a cross-platform developer-tool audience.

The docs site exposes GitHub and npm links and presents configuration, sessions, dashboard, network, CDP mode, streaming, recording, React, providers, and engines as first-class documentation sections. That suggests adoption aimed at AI-agent toolchains rather than general-purpose browser scripting alone.

How it is used

The quick-start flow is `agent-browser open`, `snapshot`, then ref-based commands such as `click @e2` and `fill @e3`. The README also documents traditional CSS selectors and semantic locators by role, label, text, placeholder, and test id.

Configuration is documented through `~/.agent-browser/config.json` and project-local `./agent-browser.json`, with environment variables and CLI flags taking precedence. The docs also publish a JSON Schema for editor autocomplete and validation.

Why package nerds care

agent-browser is interesting as a package because it packages browser automation as a standalone native CLI instead of assuming every agent runtime embeds Playwright or Puppeteer directly. The install story spans npm, Homebrew, Cargo, Scoop, Nix, Chrome for Testing, and platform dependency installation.

For package nerds watching AI tooling, it is a good example of a 2026-era CLI where MCP, plugin protocols, restoreable browser state, and agent-readable text are part of the package surface rather than optional integrations.

Timeline

2026: GitHub repository created.
2026: Early 0.x releases published.
2026: v0.26.0 added doctor, stable tab IDs, config schema, and the core skill.
2026: v0.28.0 added MCP server and plugin system.
2026: v0.30.0 added the read command.
2026: v0.31.x releases continued rapid iteration.

Related projects

Chrome for Testing is the recommended browser channel named by the README.
MCP is supported by the agent-browser CLI according to the changelog.
Playwright and Puppeteer are adjacent browser automation tools; the README notes existing installations can be detected but are not required for the daemon.

Sources

official GitHub repository metadata
official changelog and GitHub releases API
official configuration docs
official docs site
source_facts.package-manager
upstream README

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for agent-browser. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 1 runtime dependencies.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.agent-browser/config.json./agent-browser.json

executables

Installed executables

Command	Kind	Exposure	Note
`agent-browser`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.31.1

manager updated2026-06-26

local dataok

upstreamcurrent

latest detectedv0.31.1

https://github.com/vercel-labs/agent-browser

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:agent-browser
Version	0.31.1
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/agent-browser
Homepage	https://agent-browser.dev/
Repository	https://github.com/vercel-labs/agent-browser
Upstream docs	https://agent-browser.dev/
License	Apache-2.0
Source archive	https://github.com/vercel-labs/agent-browser/archive/refs/tags/v0.31.1.tar.gz
Last updated	2026-06-26T22:00:05Z
Pulse	updated
Dependencies	node
Build dependencies	rust
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared
Caveats	To complete the installation, run: agent-browser install

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	agent-browser
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

agent-browser

nix profile install nixpkgs#agent-browser

normalized package name match
Matched by: Agent Browser

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ag/agent-browser/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Scoop95%

main/agent-browser

scoop install main/agent-browser

normalized package name match
Matched by: Agent Browser

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/agent-browser.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/agent-browser.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install agent-browser with Homebrew, Nix, scoop