browser

Browser Automation with agent-browser

Installation

For normal browser work, run the requested agent-browser ... command directly. Do not run setup checks before every browser action.

Run setup only when provisioning the skill, when agent-browser is missing, or when browser dependencies need repair. If Node.js and npm are already installed, do not reinstall or replace them. Use the OS-specific Node.js install block only when node or npm is missing, then install agent-browser.

macOS and Linux

# Download and install nvm:
if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

  # In lieu of restarting the shell:
  \. "$HOME/.nvm/nvm.sh"

  # Download and install Node.js:
  nvm install 24
fi

# Verify the Node.js version:
node -v # Should print the active Node.js version.

# Verify npm version:
npm -v # Should print the active npm version.

Windows

# Download and install Chocolatey:
if (-not (Get-Command node -ErrorAction SilentlyContinue) -or -not (Get-Command npm -ErrorAction SilentlyContinue)) {
  if (-not (Get-Command choco -ErrorAction SilentlyContinue)) {
    powershell -c "irm https://community.chocolatey.org/install.ps1|iex"
  }

  # Download and install Node.js:
  choco install nodejs --version="24.16.0" -y
}

# Verify the Node.js version:
node -v # Should print the active Node.js version.

# Verify npm version:
npm -v # Should print the active npm version.

Install agent-browser

npm install -g agent-browser
agent-browser install
agent-browser install --with-deps

From Source

git clone https://github.com/vercel-labs/agent-browser
cd agent-browser
pnpm install
pnpm build
agent-browser install

Quick start

agent-browser open <url>        # Navigate to page
agent-browser snapshot -i       # Get interactive elements with refs
agent-browser click @e1         # Click element by ref
agent-browser fill @e2 "text"   # Fill input by ref
agent-browser close             # Close browser