Skip to content
BrainRoad BrainRoad
Documentation Menu

Browser Overview

Your AI helper has its own sandboxed web browser. Here is what it is and when it matters.

On this page

Your AI helper runs in its own private workspace, and that workspace includes a real web browser. When the helper needs to look something up, read a page, or work inside a web app, it drives its own copy of Chromium. You can watch that browser live from the dashboard on the Browser page.

What the browser is

The browser is a real Chromium browser running inside your helper’s isolated workspace, on a virtual 1920x1080 display. It is not a simulation or a set of screenshots. When the helper opens a page, clicks a link, or fills in a field, that happens in an actual browser session that belongs only to your account.

The helper connects to this browser automatically. You do not set anything up. When a task needs the web, the helper opens pages there; when nothing needs the web, the browser sits idle on a blank tab.

Why watch it

The live view is useful when your helper is:

  • Researching a topic, a supplier, or a competitor. You can see which pages it reads.
  • Working inside a web app you have given it access to. You can see exactly what it does there.
  • Stuck. If a task involving a website goes sideways, the Browser page shows you the page the helper is looking at, which is usually where the answer is.

Watching is optional. The helper does its browsing whether or not you have the page open.

Browsing and the review step

Reading the web is something the helper does on its own. The review step (the Inbox) covers the actions BrainRoad sends on your behalf, like customer email replies, which always start as drafts you approve. Work the helper does directly inside a website you have connected it to follows that site’s own rules, not the Inbox. If you give the helper credentials to a web tool, treat that the way you would treat giving them to a contractor.

For technical users

The browser runs as a sidecar container next to the helper, and it exposes the Chrome DevTools Protocol (CDP) inside the workspace on port 9222. The helper attaches to it over CDP. From the Console you can check it yourself:

curl http://localhost:9222/json/version

That endpoint is only reachable from inside your own workspace.