agent-browser

name	agent-browser
description	Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
allowed-tools	Bash(agent-browser:*)

Browser Automation with agent-browser

Core Workflow

Every browser automation follows this pattern:

1. Navigate: agent-browser open <url>
2. Snapshot: agent-browser snapshot -i (get element refs like @e1, @e2)
3. Interact: Use refs to click, fill, select
4. Re-snapshot: After navigation or DOM changes, get fresh refs

agent-browser open https://example.com/form
agent-browser snapshot -i
# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"

agent-browser fill @e1 "[e-mail]"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i  # Check result

Essential Commands

# Navigation
agent-browser open <url>              
agent-browser close                   


agent-browser snapshot -i             
agent-browser snapshot -i -C          
agent-browser snapshot -s  


agent-browser click @e1               
agent-browser fill @e2          
agent-browser  @e2          
agent-browser  @e1      
agent-browser check @e1               
agent-browser press Enter             
agent-browser scroll down 500         


agent-browser get text @e1            
agent-browser get url                 
agent-browser get title               


agent-browser  @e1                
agent-browser  --load networkidle 
agent-browser  --url     
agent-browser  2000               


agent-browser screenshot              
agent-browser screenshot --full       
agent-browser pdf output.pdf