# Install agent-browser with Homebrew, Nix, scoop Browser automation CLI for AI agents. Version 0.31.1 via Homebrew; verified 2026-06-26. ## Install ```sh sudo av install brew:agent-browser ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install agent-browser ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#agent-browser ``` Evidence: nixpkgs package indexes: pkgs/by-name/ag/agent-browser/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/agent-browser ``` Evidence: Scoop official bucket manifest trees: bucket/agent-browser.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:agent-browser - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.31.1 - **Source summary:** Browser automation CLI for AI agents - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-26T22:00:05Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - agent-browser (cli) - agent-browser (alias) ## Dependencies - node ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Caveats: To complete the installation, run: agent-browser install - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.31.1 - Package-manager updated: 2026-06-26 - Local data: ok - Upstream repository: https://github.com/vercel-labs/agent-browser - Upstream latest detected: v0.31.1 (current) ## 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 Notes 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. ## 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 - Unix: ~/.agent-browser/config.json, ./agent-browser.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** agent-browser - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - agent-browser: normalized package name match | nixpkgs package indexes: pkgs/by-name/ag/agent-browser/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Scoop - main/agent-browser: normalized package name match | Scoop official bucket manifest trees: bucket/agent-browser.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [chrome-cli](https://www.automicvault.com/pkg/brew/chrome-cli/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [chrome-devtools-mcp](https://www.automicvault.com/pkg/brew/chrome-devtools-mcp/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [geckodriver](https://www.automicvault.com/pkg/brew/geckodriver/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [playwright-cli](https://www.automicvault.com/pkg/brew/playwright-cli/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [playwright-mcp](https://www.automicvault.com/pkg/brew/playwright-mcp/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [selenium-server](https://www.automicvault.com/pkg/brew/selenium-server/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [slimerjs](https://www.automicvault.com/pkg/brew/slimerjs/) - Shares av.db curated category or tags: browser-automation, cli, developer-tools. - [gbox](https://www.automicvault.com/pkg/brew/gbox/) - Shares av.db curated category or tags: ai-agents, browser-automation, cli, developer-tools. - [agent-browser](https://www.automicvault.com/pkg/npm/agent-browser/) - Same normalized package name appears in another local ecosystem. Shared terms: agent, agent-browser, agents, ai, automation. - [agent-browser](https://www.automicvault.com/pkg/npm/agent-browser/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/agent-browser.yml](https://github.com/automic-vault/db/blob/main/combined/agent-browser.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph