Skip to content
fastbrowsefastbrowse

Browsers and logins

Run a browser agent in your own signed-in Chrome

Install the fastbrowse extension, check it is connected, run a read-only task with --extension, and stop it. What the run can reach and what Chrome shows.

·verified against v0.11.0 on ·this post’s source·all posts

A terminal task in your own Chromefastbrowse sends browser commands through native messaging to the Chrome extension. The extension works in the run's own tab group, using the sign-ins in that browser.fastbrowse CLI--extension --browserChrome extensionnative messagingYour own Chromerun-owned tab groupOpen the extension popup to see the run and stop it.Chrome shows its debugging bar while the run works.
Start a task in your terminal. The extension connects fastbrowse to your own Chrome and gives the run a tab group. Page content can go to the model providers you configure.

A fresh browser has none of your sign-ins. The fastbrowse extension lets a run work in the Chrome you already use, where you are signed in. The run opens tabs of its own in that browser; it does not use the tabs you already have open. No Browser Use key is involved: the run uses your own browser and your own model key.

Set up

You need uv, Chrome 125 or later (fastbrowse extension install also registers Edge, Brave and Chromium) and a model key. OPENROUTER_API_KEY covers the model calls and the Jev decision calls.

uv tool install fastbrowse
export OPENROUTER_API_KEY=...
fastbrowse extension install

fastbrowse extension install registers fastbrowse with every Chromium browser it finds for your user, then prints the store link. It writes a small launcher and a native-messaging manifest into your user folders, and needs no admin rights. Run it again if you move or reinstall fastbrowse.

Next, add the extension from the Chrome Web Store, then restart Chrome or turn the extension off and on at chrome://extensions so it connects. The first task below is the check: with no browser connected, the run ends unavailable. Open fastbrowse from Chrome's Extensions menu to see active runs and their Stop buttons.

The extension has to match the fastbrowse you install: the Store's 0.1.0 works with fastbrowse 0.10.x, and fastbrowse 0.11.0 or later requires extension 0.1.1 or later with its supported-command list. A run that finds an older extension stops before it spends anything and names the version it needs. If the Store does not list the version you need yet, run fastbrowse extension path, open chrome://extensions, enable Developer mode, choose Load unpacked and select the printed folder.

Run a read-only task first

Browser tasks use the extension by default. --extension makes that choice explicit.

fastbrowse "What is the title of the top story?" \
  --start https://news.ycombinator.com/ --extension --browser

The run opens a tab group named fastbrowse: <your task>, works in it, and prints the answer with the quotes it came from. Only complete is a success, and the command exits 0 only for complete.

With no browser connected, the run ends unavailable before it spends anything. It never falls back to another browser.

What happens to your tabs

Stop a run

Any of these ends the run cancelled (exit 12), and the error says which one:

The result keeps the steps taken and the money spent.

What the run can reach

The extension relays page-level commands to the tabs the run opened: clicks, typing, navigation, reading the page and screenshots. It cannot read cookies, saved passwords or other sites' storage through browser APIs. fastbrowse accepts connections only from the extension's ID, over a socket only your user can open.

The extension itself talks only to fastbrowse on your computer. fastbrowse sends the pages a run reads to the model providers you configured: page text and screenshots to the LLM and to Jev, which OPENROUTER_API_KEY routes through OpenRouter. Pages you are signed in to count. Choose tasks and providers with that in mind.

Two more things to know:

More than one browser

With the extension in more than one browser, give each a name in its popup, then pick one:

fastbrowse "What is the title of the top story?" \
  --start https://news.ycombinator.com/ --extension --extension-browser work --browser

Remove it

fastbrowse extension uninstall removes what install wrote. Remove the extension itself at chrome://extensions.

For other ways to reach a browser, see attaching to a running Chrome.

For connection errors, see the extension connection checks.

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