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

Search smoke test

Verify the standalone search pipeline works end-to-end. This runs without a browser by default (--browser never restricts to HTTP-only fetch).

agbrowse search "agbrowse npm package" --json --browser never

If the result includes an evidenceStatus of sufficient or partial, the fetch ladder and evidence scorer are working correctly.

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