browser-tools

1# Browser Tools
2 
3Chrome DevTools Protocol tools for agent-assisted web automation. These tools connect to Chrome running on `:9222` with remote debugging enabled.
4 
5## Setup
6 
7Run once before first use:
8 
9```bash
10cd {baseDir}/browser-tools
11npm install
12```
13 
14## Start Chrome
15 
16```bash
17{baseDir}/browser-start.js              # Fresh profile
18{baseDir}/browser-start.js --profile    # Copy user's profile (cookies, logins)
19```
20 
21Launch Chrome with remote debugging on `:9222`. Use `--profile` to preserve user's authentication state.
22 
23## Navigate
24 
25```bash
26{baseDir}/browser-nav.js https://example.com
27{baseDir}/browser-nav.js https://example.com --new
28```
29 
30Navigate to URLs. Use `--new` flag to open in a new tab instead of reusing current tab.
31 
32## Evaluate JavaScript
33 
34```bash
35{baseDir}/browser-eval.js 'document.title'
36{baseDir}/browser-eval.js 'document.querySelectorAll("a").length'
37```
38 
39Execute JavaScript in the active tab. Code runs in async context. Use this to extract data, inspect page state, or perform DOM operations programmatically.
40 
41## Screenshot
42 
43```bash
44{baseDir}/browser-screenshot.js
45```
46 
47Capture current viewport and return temporary file path. Use this to visually inspect page state or verify UI changes.
48 
49## Pick Elements
50 
51```bash
52{baseDir}/browser-pick.js "Click the submit button"
53```
54…