Skip to main content

Browser — web automation

The Browser panel lets the agent browse the web inside the desktop app. It opens pages, reads content, fills forms, takes screenshots, and interacts with elements — all visible to you in a side panel.

Browser vs. web search tool

Headmaster has two web-related capabilities: The agent picks the right one based on your request. If you need visual output or form interaction, it uses the Browser. If you just need information, it uses the web search tool.

Opening the Browser

  • From the sidebar — click the Browser icon. A panel opens next to the chat with a URL bar.
  • From chat — ask the agent to browse: “open github.com and find the latest release notes.” The agent opens the URL and starts working.

What the agent can do

The agent opens the URL, waits for the page to load, extracts the text content, and summarizes it in the chat.
The agent navigates to the page, fills in the fields, and stops. You review the filled form in the Browser panel and tell the agent to submit or make changes.
The agent opens the URL, waits for the page to load, captures a screenshot, and saves it to your project folder. The screenshot also appears in the chat.
The agent opens a search engine, runs the query, reads the results page, and extracts the top results.
The agent downloads the file and saves it to the project folder. The file appears in the File Manager.

Browser panel controls

You can interact with the browser directly while the agent is working — the agent sees your interactions and incorporates them.

Browser and approvals

In Work Along mode, the agent asks before:
  • Navigating to a new URL
  • Submitting a form
  • Downloading a file
  • Clicking a button that triggers an action
In Run It Yourself and Hands-Off modes, the agent browses without per-action approval.

Anti-detection

The browser uses anti-detection measures to avoid being blocked by sites that detect automated browsers:
  • Realistic user agent strings
  • Realistic viewport sizes
  • Human-like interaction delays
  • Canvas and WebGL fingerprint randomization

Approvals

Control which browser actions need your approval.

File management

Files downloaded by the browser appear in the File Manager.