Headless browser automation using agent-browser CLI
Control a headless browser for web automation, scraping, and testing.
agent-browser CLI installed globally (npm install -g agent-browser)agent-browser install)# Install agent-browser CLI
npm install -g agent-browser
# Download Chrome for Testing
agent-browser install --with-deps # Linux
agent-browser install # macOS/Windows
agent-browser open https://example.com
agent-browser snapshot -i
agent-browser click @e1 # Click by ref
agent-browser fill @e2 "text" # Fill input
agent-browser press Enter # Press key
agent-browser get text @e1 # Get text content
agent-browser get url # Get current URL
agent-browser screenshot page.png # Take screenshot
agent-browser close # Close browser
agent-browser open https://site.com/login
agent-browser snapshot -i
agent-browser fill @email "[email protected]"
agent-browser fill @password "secretpass"
agent-browser click @submit
agent-browser wait --text "Welcome"
agent-browser open https://news.ycombinator.com
agent-browser snapshot -i
agent-browser get text @e1
agent-browser open https://google.com
agent-browser screenshot --full page.png
--json - JSON output for parsing--headed - Show browser window (for debugging)--session-name <name> - Persist session cookies--profile <path> - Use persistent browser profileThe browser tool is enabled by default with allowed_domains = ["*"] and
backend = "agent_browser". To customize, edit ~/.zeroclaw/config.toml:
[browser]
enabled = true # default: true
allowed_domains = ["*"] # default: ["*"] (all public hosts)
backend = "agent_browser" # default: "agent_browser"
native_headless = true # default: true
To restrict domains or disable the browser tool:
[browser]
enabled = false # disable entirely
# or restrict to specific domains:
allowed_domains = ["example.com", "docs.example.com"]
Run agent-browser --help for all available commands.