Concept

The runtime reuses headed Chrome and keeps each CLI command short-lived.

Commands connect to a CDP port, inspect or mutate the current target, then exit. Browser state and Web-AI session metadata live under BROWSER_AGENT_HOME.

Operating model

agbrowse start --headed launches or reuses Chrome.
Snapshots produce refs; actions consume refs or explicit selectors.
Tab lifecycle cleanup keeps provider pools bounded.
Headless browser state is rejected for Web-AI commands that need visible UI.

Diagnostics

agbrowse status --json
agbrowse tabs --json
agbrowse console --limit 50
agbrowse network --duration 1000

Web-AI sessions Config