Browser Automation via Chrome Debug Session

Browse the web, fill forms, scrape data, and automate any browser task using agent-browser connected to your logged-in Chrome session via CDP on port 9222.

Always use --cdp 9222 to connect to your existing Chrome with saved logins. Never use --auto-connect — that opens a fresh unauthenticated browser.

Core Workflow

Every browser task follows this loop:

1. Navigate: agent-browser --cdp 9222 open <url>
2. Snapshot: agent-browser --cdp 9222 snapshot -i (get element refs like @e1, @e2)
3. Interact: Use refs to click, fill, select
4. Re-snapshot: After any page change, get fresh refs (they invalidate on DOM changes)

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