Documentation

Browser

Agent Zero has a built-in Browser for research, forms, screenshots, UI review, downloads, extensions, and anything else that works best in a real browser.

Browser Canvas and tool history

Open The Browser Surface

Open the right-side Canvas, select Browser, then click Open Browser or the plus button to create a new tab. The Browser surface shows tabs, back and forward controls, reload, an address bar, annotations, and settings.

Focused Browser surface with a live page

Ask The Agent To Browse

You can ask naturally: Use the Browser tool to open https://example.com, read the page content, and take a screenshot. Agent Zero can open pages, read content, click, type, upload files, and capture screenshots.

Browser tool history in chat

Annotate Pages

Annotate mode lets you mark a page element or region and send a targeted comment back into the chat. Click Annotate, wait for it to switch to Annotating, then point at the page area you want Agent Zero to notice.

Focused Browser surface with Annotating mode enabled

Browser Settings

Open Browser settings from the Browser toolbar or from Browser plugin settings. Configure the Browser location, page content access, starting page, autofocus, and Docker-browser extensions.

Safety note: Agent Zero does not require an official Chrome extension. If a website, message, or package tells you to install an “Agent Zero Chrome extension,” do not install it.

Browser toolbar settings Browser plugin settings

Bring Your Own Browser

Bring Your Own Browser lets Agent Zero use Chrome, Edge, or Chromium on your computer through the A0 CLI connector. Use it when a login, profile, or page should stay on your machine.

Once A0 CLI is connected and host browser mode is active, you can control the host browser from Agent Zero Web UI as well. The Browser plugin settings surface the same mode, profile, and page-content policy controls.

Browser plugin settings showing Bring Your Own Browser mode

You can also manage the same flow from A0 CLI with the Browser commands. Use /browser status to check the connection, /browser host on to switch the chat to host-browser mode, and /browser relaunch to manually open or relaunch the host browser and trigger the browser approval prompt.

A0 CLI Browser command palette A0 CLI Browser status A0 CLI Bring Your Own Browser mode

If you use an existing Chrome-family browser profile, visit chrome://inspect/#remote-debugging and enable remote debugging for that browser instance. Chrome shows an Allow prompt the first time Agent Zero tries to control that browser.

Host browser remote debugging setting Host browser remote debugging allow prompt

Important: remote debugging grants control of that browser session, including cookies and site data. Enable it only for browser instances you intend Agent Zero to control.

Troubleshooting

  • If the Browser surface does not open automatically, open it manually from Canvas.
  • If Canvas does not follow the agent, enable Autofocus active page.
  • If host-browser content is blocked, switch to a local model or adjust Browser page content access.