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