docs
Command-line flags
Every flag the fastbrowse command takes: the start page, browser choice, authorization, secrets, limits, traces and recordings.
Raw Markdown·Source at the pinned commit
Flags
Steps go to stderr; the status, cost, step count, why a run stopped short, and the answer go to stdout. --json
prints the full result: every step, the quotes behind the answer, and cost by component.
| Flag | Effect |
|---|---|
--start URL | the first page; worked out from the task when omitted |
--context TEXT | background the run may use but never treats as the task |
--extension | run in your own Chrome, signed in as you are, through the fastbrowse extension; this is the default for a browser task, see Your own Chrome |
--local | an alias for --extension |
--extension-browser LABEL | with the extension connected in more than one browser, use the one its popup labels LABEL |
--cloud | run in a Browser Use Cloud browser instead, which needs BROWSER_USE_API_KEY |
--cloud-profile ID | with --cloud, run on a signed-in Browser Use Cloud profile |
--fetch | read pages over HTTP with no browser, for a task that only reads |
--desktop APP | start a Linux desktop app and drive it instead of a browser, through deskpilot; see Desktop apps |
--browser | start a cloud browser from the first step, rather than reading over HTTP until the task needs one; extension runs already start in Chrome |
--viewport WIDTHxHEIGHT | with --cloud, the screen size requested from the cloud Chrome; does not emulate mobile, touch, device scale or user agent. Refused without --cloud |
--attach | with the extension, drive the window you have open instead of a tab of its own |
--target-match TEXT | with the extension, attach to the first window whose title or URL contains TEXT (implies --attach) |
--foreground | bring the run's tab to the front instead of working behind the current one |
--proxy-country CC | with --cloud, browse from that country (uk, de, ...; default us); starts the cloud browser before reading |
--authorize | allow submit, pay, delete and send; otherwise the run stops at needs_confirmation. It does not override a task that says to change nothing or not to download |
--secret NAME=ENV_VAR[@ORIGIN] | let the agent type $ENV_VAR on ORIGIN (https://*.site.com covers its hosts), or on the --start origin; models see NAME only |
--bitwarden ITEM | use a vault login on the origin its saved URIs match, including its one-time code |
--max-steps N, --max-dollars N | bound steps and model and web-search spend; unlimited by default |
--downloads DIR | keep downloaded files |
--json | print the full result |
--trace FILE | append each model call with its full request and reply, read and check, and with --extension every message to and from the extension (image data left out), to FILE as JSON lines (- for stderr); FASTBROWSE_TRACE does the same for serve and MCP. The requests carry page text, so treat a trace as you would the pages |
--record FILE | save a captioned MP4 of the run (needs ffmpeg); it shows what the pages showed, so watch it before sharing |
--recipe FILE | replay a recipe: offer Jev each saved action alone where its page and control match, and reuse saved values |
--input NAME=VALUE | a named value the task refers to ("the person named in input person"), typed into a field by name; a recipe saved with it types the next run's value (repeatable) |
--file PATH | a local file the run may attach to a file input on the page, offered under its file name, so a task can say "upload shrike_lid.stl"; the file is read when the run starts and sent to the page as bytes, also to a browser on another machine (repeatable) |
--save-recipe FILE | write the run's steps as a recipe when it ends complete; naming the --recipe file repairs it after steps the agent had to decide |
--no-cursor | don't draw the agent's cursor. By default it is drawn over a Chrome window that shows the run (--foreground, or an attached front tab) with fastbrowse's focus marker through Cua Driver 0.45.4 or later on X11, or with deskpilot on Hyprland, and skipped anywhere else |
--cursor | also bring the window to the front, including with --extension, so the live cursor can be drawn |
On X11, fastbrowse installs its own versioned Cua theme on first use and keeps the live marker visible between steps. To keep it upright and still at rest, run these with Cua Driver's daemon running. They apply to every Cua cursor:
cua-driver config set cursor.rotate off
cua-driver config set cursor.float off
export SAUCE_PASSWORD=secret_sauce
fastbrowse "Log in as standard_user with the saved password and add the backpack to the cart." \
--start https://www.saucedemo.com/ --secret password=SAUCE_PASSWORD --authorize
The CLI refuses --headed, --profile, --cdp-url and --cdp-port. A profile
of its own, a headless Chrome or a DevTools endpoint is the Python, Node and Go SDKs' job: see
A profile of its own and Open windows and Electron apps.
Related guides
- Cap browser automation cost per run
What a fastbrowse run reports it spent, what each charge is for, and how to cap a run with --max-dollars and --max-steps.
- Connect an agent to a running Chrome over CDP
Drive signed-in Chrome through the fastbrowse extension, or connect an SDK to an Electron app over its DevTools port.
hosted
Run fastbrowse over an API
The same agent behind an API. Keys, secrets, run history and spend limits live in the console. Free to start.