Skip to content

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