Skip to content
BrainRoad BrainRoad
Documentation Menu

Using the Browser Tab

How to view and interact with your agent's browser session.

On this page

The Browser tab is available on every agent’s detail page. It shows a live feed of what the agent’s headless browser is rendering.

Accessing the Browser Tab

  1. Open the dashboard and navigate to your agent.
  2. On the agent detail page, click the Browser tab.
  3. The browser view loads and fills the available display area.

The view scales to fit your screen. On wider monitors, you get a larger, more detailed view of what the agent is seeing.

What You See

The browser feed shows the rendered webpage exactly as the agent’s headless Chromium sees it. This includes page content, images, form fields, buttons, and navigation elements. As the agent interacts with the page, you see clicks, scrolling, text entry, and page transitions in real time.

Active vs Idle States

The browser is not always in use. Your agent only opens the browser when a task requires web access. When the agent is working on non-web tasks like writing, coding, or processing files, the browser sits idle.

  • Active — The agent is navigating a site. The feed shows live page content updating as the agent works.
  • Idle — No web task is in progress. The feed may show a blank page or the last page the agent visited.

When to Use the Browser Tab

Open the Browser tab when you want to observe your agent performing web-based work. It is particularly useful for verifying that the agent is visiting the right sites, reading the correct content, and interacting with web pages as expected. If the agent reports trouble with a web task, the Browser tab gives you direct visibility into what went wrong.

The browser view is read-only from the dashboard. You observe what the agent does but do not control the browser directly. To influence the agent’s behavior, give it new instructions through the chat interface.