Skip to content
fastbrowsefastbrowse

docs

Run statuses and exits

Every status and exit code, what complete means, and how a run reports an exhausted budget.

Raw Markdown·Source at the pinned commit

Results

The exit code is the status. Only complete exits 0; configuration refusals exit 1 and bad syntax exits 2.

StatusExitMeaning
complete0Jev judged the task done
unverified10Jev finished, but the requested data could not be filled from the page or the site refused a requested step
needs_confirmation3stopped before an irreversible action; re-run with --authorize
needs_login4a sign-in wall that no --secret covers
blocked6a bot check (a CAPTCHA) that did not clear; not a sign-in, so no secret passes it
needs_input5a required value or file is missing, or an upload exceeds the configured size limit
stuck9the stall budget ran out without reaching a page state the run had not seen
budget_exceeded7a resource limit was reached, or a missing cost prevents enforcing the dollar cap
observation_limit11the page or required evidence cannot fit the configured prompt budget
unavailable8a model or browser provider stayed unavailable through every retry, or the page says an item the task requires cannot be bought; the same run later may pass
cancelled12you stopped an --extension run in your browser: from its popup, the debugging bar or by closing its tabs
error1a model or browser failure

The JSON result says why a run stopped where a caller can act on it:

  • budget names the limit a budget_exceeded run hit (steps, seconds, dollars, jev_calls or llm_calls) and its value.
  • browser says which browser the run drove: via is cloud, launched, attached or extension, with the profile and the browser product and version where known. A run that read every page over HTTP has none.
  • wall describes a needs_login or blocked page: its kind (password, one_time_code, sign_in or bot_check), origin, the fields it asked for and seen_at_ms. A caller that can read the user's email or texts can answer a one_time_code wall with a secret scoped to that origin and run again.
  • A run that stops before completion can retain a cited partial answer from checked claims while their source evidence remains unchanged. A stuck or unverified run can also compose an answer from evidence it read. Partial answers may start with Partial evidence only., and one from a run that left a step of its task undone starts by saying so; the status determines whether the task completed.

A cost a provider omits is looked up from its receipt, or bounded from OpenRouter's listed prices. A cost that cannot be bounded is unknown, and a run with a dollar cap then stops with budget_exceeded. A page that stops answering (15 seconds for an input event, 120 for any other command) is reopened once during an action; a second hang returns unavailable. Step and dollar limits do not bound elapsed time: Limits(max_seconds=...) does.

A run's proxy cost line on a Browser Use Cloud browser has the basis unsettled: the service meters proxy data about 30 seconds after a browser stops, and a run returns without waiting, so the figure can read low. An unsettled line makes the total incomplete, even when it carries a provisional dollar figure. The browser_id in the run's browser event reads the settled figure from GET /browsers/{id} once that time has passed.

Updating

fastbrowse self-update prints how this copy was installed and the command or link that upgrades it, then exits 0. It reads what the installer recorded and makes no network call, and it never replaces the running binary.

Installed withIt prints
uv tool install fastbrowseuv tool upgrade fastbrowse
uvx fastbrowseuvx fastbrowse@latest
uv add or uv pip installuv lock --upgrade-package fastbrowse && uv sync, or uv pip install --upgrade fastbrowse
pip install fastbrowsepython -m pip install --upgrade fastbrowse
npm install fastbrowsenpm install fastbrowse@latest
A release binarythe latest release link and this platform's fastbrowse-rust-<target>.tar.gz
A checkoutgit pull && uv sync --all-extras

Another installer, or one that left no record, gets the PyPI page.

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