Skip to content

First run

# Verify the local browser contract before automation.

agbrowse does not hide browser state. It connects to headed Chrome, reads the current target, and fails closed when a required browser or provider condition is missing.

## Checklist

- Run `agbrowse start --headed`.
- Use `agbrowse status --json` to confirm the CDP port and headed state.
- Run `agbrowse snapshot --interactive` before click/type actions.
- For Web-AI, log into the provider manually in the same browser profile.

    agbrowse status --json
    agbrowse tabs --json
    agbrowse web-ai status --vendor chatgpt --json

## Fail-closed behavior

Set `AGBROWSE_WEB_AI_AUTO_START=0` when scripts must fail instead of starting Chrome. Code-mode flag errors are rejected before browser startup.

    AGBROWSE_WEB_AI_AUTO_START=0 \
    agbrowse web-ai code --vendor gemini --prompt x --json

Browser runtime Config reference