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.
| Status | Exit | Meaning |
|---|---|---|
complete | 0 | Jev judged the task done |
unverified | 10 | Jev finished, but the requested data could not be filled from the page or the site refused a requested step |
needs_confirmation | 3 | stopped before an irreversible action; re-run with --authorize |
needs_login | 4 | a sign-in wall that no --secret covers |
blocked | 6 | a bot check (a CAPTCHA) that did not clear; not a sign-in, so no secret passes it |
needs_input | 5 | a required value or file is missing, or an upload exceeds the configured size limit |
stuck | 9 | the stall budget ran out without reaching a page state the run had not seen |
budget_exceeded | 7 | a resource limit was reached, or a missing cost prevents enforcing the dollar cap |
observation_limit | 11 | the page or required evidence cannot fit the configured prompt budget |
unavailable | 8 | a 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 |
cancelled | 12 | you stopped an --extension run in your browser: from its popup, the debugging bar or by closing its tabs |
error | 1 | a model or browser failure |
The JSON result says why a run stopped where a caller can act on it:
budgetnames the limit abudget_exceededrun hit (steps,seconds,dollars,jev_callsorllm_calls) and its value.browsersays which browser the run drove:viaiscloud,launched,attachedorextension, with theprofileand thebrowserproduct and version where known. A run that read every page over HTTP has none.walldescribes aneeds_loginorblockedpage: itskind(password,one_time_code,sign_inorbot_check),origin, thefieldsit asked for andseen_at_ms. A caller that can read the user's email or texts can answer aone_time_codewall 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
stuckorunverifiedrun can also compose an answer from evidence it read. Partial answers may start withPartial 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 with | It prints |
|---|---|
uv tool install fastbrowse | uv tool upgrade fastbrowse |
uvx fastbrowse | uvx fastbrowse@latest |
uv add or uv pip install | uv lock --upgrade-package fastbrowse && uv sync, or uv pip install --upgrade fastbrowse |
pip install fastbrowse | python -m pip install --upgrade fastbrowse |
npm install fastbrowse | npm install fastbrowse@latest |
| A release binary | the latest release link and this platform's fastbrowse-rust-<target>.tar.gz |
| A checkout | git pull && uv sync --all-extras |
Another installer, or one that left no record, gets the PyPI page.
Related guides
- How to verify browser agent results
What each fastbrowse run status and exit code means, how citations back an answer, and what to do when a run ends unverified.
- 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.
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.