Web Browser

Use the unique target prefix from list for all tab commands.

Core commands

./scripts/cdp.mjs list
./scripts/cdp.mjs shot <target> [file]
./scripts/cdp.mjs snap <target>
./scripts/cdp.mjs html <target> [".selector"]
./scripts/cdp.mjs eval <target> "expression"
./scripts/cdp.mjs nav <target> https://example.com
./scripts/cdp.mjs net <target>
./scripts/cdp.mjs click <target> "selector"
./scripts/cdp.mjs clickxy <target> <x> <y>
./scripts/cdp.mjs type <target> "text"
./scripts/cdp.mjs loadall <target> "selector"
./scripts/cdp.mjs evalraw <target> <method> [json]
./scripts/cdp.mjs open [url]
./scripts/cdp.mjs stop [target]

Notes:

• clickxy uses CSS pixels, not screenshot image pixels
• type uses CDP input events and is better than JS eval for text entry
• first access to a tab may trigger Chrome's approval prompt; repeated commands reuse a persistent daemon

Helper scripts

Pick elements

./scripts/pick.js "Click the submit button"

Interactive picker for the active page.

Dismiss cookie dialogs

./scripts/dismiss-cookies.js
./scripts/dismiss-cookies.js --reject

Runs against the active page and attempts to accept or reject common consent dialogs.

Background logging

./scripts/watch.js
./scripts/logs-tail.js
./scripts/logs-tail.js --follow
./scripts/net-summary.js

Writes JSONL logs to:

~/.cache/agent-web/logs/YYYY-MM-DD/<targetId>.jsonl

Legacy wrappers

These wrappers now delegate to cdp.mjs:

./scripts/nav.js <target> <url>
./scripts/eval.js <target> "expression"
./scripts/screenshot.js <target> [file]

Best practices

• Prefer stable selectors over index-based DOM access across multiple commands
• Use snap for semantic structure and html when you need exact markup
• Use evalraw for unsupported CDP methods instead of adding one-off scripts
• Use browser interaction only when the user explicitly wants page inspection or manipulation