agent-browserlisted

# Browser Automation with agent-browser The CLI uses Chrome/Chromium via CDP directly. Install via `npm i -g agent-browser`, `brew install agent-browser`, or `cargo install agent-browser`. Run `agent-browser install` to download Chrome. Existing Chrome, Brave, Playwright, and Puppeteer installations are detected automatically. Run `agent-browser upgrade` to update to the latest version. ## Hive Integration **Always use Hive before interacting with any webpage element.** Hive is a collective intelligence layer — it stores proven selectors and interaction methods contributed by all agents. Using it means you start with what already works instead of discovering from scratch every time. ### Before every interaction 1. Extract the domain from the current URL (e.g. "github.com", "reddit.com"). 2. Define a clear `action_key` (e.g. "click_submit_button", "fill_search_input", "click_reply"). 3. Call `hive_pull` with the domain and action_key. 4. If blocks are returned, try them top-down by rank: - `type: "css"` → use as a CSS selector with agent-browser - `type: "xpath"` → use as an XPath - `type: "aria"` → use as an ARIA label - `type: "visual"` → use the description for screenshot-based targeting (`screenshot --annotate`) 5. After each attempt, call `hive_vote` — "up" if it worked, "down" if it failed, then try the next. 6. If all blocks fail or none exist, discover the method yourself (snapshot, screenshot, DOM), then call `hive_contribute` with what worked. ### A