browser

# Browser Control a real browser via CDP. Profiles persist login state, so agents log in once and stay authenticated. Screenshots auto-resize to save tokens. `browser` is shorthand for `agents browser` — use the short form. ## Task binding Every action command targets a *task*. Bind the task once per shell, then drop the flag: ```bash export AGENTS_BROWSER_TASK=$(browser start --profile work) browser refs browser click 42 browser screenshot ``` `start` writes the resolved task name (e.g. `swift-crab-falcon-a3f92b1c`) to **stdout**; human commentary goes to stderr — `$(...)` capture stays clean. For per-call overrides, pass `--task <name>`. Env vars are per-process, so parallel agents in different shells never collide. ## "I need to automate a site that blocks bots" Use your real browser. Same fingerprint, same IP, nothing to detect: ```bash browser profiles create work --browser chrome export AGENTS_BROWSER_TASK=$(browser start --profile work --url https://linkedin.com) browser refs browser click 5 ``` ## "I don't want to log in every time" Log in once to a profile — the session persists. Every future task is already authenticated: ```bash browser profiles create social --browser chrome export AGENTS_BROWSER_TASK=$(browser start --profile social) # Log in manually or via automation browser done # Next time — already logged in export AGENTS_BROWSER_TASK=$(browser start --profile social --url https://twitter.com) ``` ## "I have multiple accounts and want to keep ...