Agent Browser

agent-browser drives Chrome over the DevTools Protocol from the shell. A snapshot returns the accessibility tree with an @eN ref per element; you act on refs, then observe again. This skill decides when and how carefully to use it. The CLI ships its own command guides, matched to the installed version, so flags are never copied here.

Before the First Command

command -v agent-browser && agent-browser --version
agent-browser skills get core                 # read once per session; routes to references
S="$(agent-browser session id --scope worktree --prefix task)"

• In zsh, quote refs and brace any variable that a colon follows ("${host}:9222", "@${ref}"): an unbraced $x:e… or $x:h… is read as a zsh history modifier and silently mangled.
• Pass --session "$S" on every command. Each shell call is fresh, so an exported variable is lost, and the default session is a browser shared with other agents and the human.
• Load a specialised guide only when needed: skills get dogfood, electron, derive-client, or skills get core --ref <name> for commands, auth, sessions, trust boundaries, or profiling.
• If a command fails unexpectedly, run agent-browser doctor before improvising. doctor --fix performs destructive repairs, so ask first.

Choose the Tool