Skip to content
fastbrowsefastbrowse

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.

FlagEffect
--start URLthe first page; worked out from the task when omitted
--context TEXTbackground the run may use but never treats as the task
--extensionrun 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
--localan alias for --extension
--extension-browser LABELwith the extension connected in more than one browser, use the one its popup labels LABEL
--cloudrun in a Browser Use Cloud browser instead, which needs BROWSER_USE_API_KEY
--cloud-profile IDwith --cloud, run on a signed-in Browser Use Cloud profile
--fetchread pages over HTTP with no browser, for a task that only reads
--desktop APPstart a Linux desktop app and drive it instead of a browser, through deskpilot; see Desktop apps
--browserstart a cloud browser from the first step, rather than reading over HTTP until the task needs one; extension runs already start in Chrome
--viewport WIDTHxHEIGHTwith --cloud, the screen size requested from the cloud Chrome; does not emulate mobile, touch, device scale or user agent. Refused without --cloud
--attachwith the extension, drive the window you have open instead of a tab of its own
--target-match TEXTwith the extension, attach to the first window whose title or URL contains TEXT (implies --attach)
--foregroundbring the run's tab to the front instead of working behind the current one
--proxy-country CCwith --cloud, browse from that country (uk, de, ...; default us); starts the cloud browser before reading
--authorizeallow 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 ITEMuse a vault login on the origin its saved URIs match, including its one-time code
--max-steps N, --max-dollars Nbound steps and model and web-search spend; unlimited by default
--downloads DIRkeep downloaded files
--jsonprint the full result
--trace FILEappend 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 FILEsave a captioned MP4 of the run (needs ffmpeg); it shows what the pages showed, so watch it before sharing
--recipe FILEreplay a recipe: offer Jev each saved action alone where its page and control match, and reuse saved values
--input NAME=VALUEa 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 PATHa 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 FILEwrite 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-cursordon'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
--cursoralso 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.

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.

create an account·plans and pricing