Skip to main content

Browser Use

Browser Use lets AdaL work with a real browser while you stay in the terminal. It is useful when a task needs browser interaction with visual context, page interaction, or live web app debugging.

Use it for things like:

  • Automating your web workflow
  • Testing and debugging a website
  • Reaching out to someone on social media
  • Searching for information on the web
  • Basically everything you do with a web browser

Quick Start​

Browser Use is one of AdaL's main agents. Select it from the agent picker at any time — even mid-conversation.

adal
/agent

Use ↑/↓ to navigate and Enter to select Browser Use. AdaL opens a dedicated Chrome window and is ready to drive the browser.

For headless or scripted runs, see Headless Mode and use:

adal -q "open staging.example.com and verify the login flow" --agent-mode browser-use

Prerequisites​

Browser Use works out of the box on macOS and Windows when Google Chrome is already installed.

If Chrome isn't installed, or you're running on Linux / WSL, install Chromium manually for your platform:

How the Browser Opens​

When you select Browser Use, AdaL opens a dedicated Chrome window for its own use, so your everyday browser stays untouched. Switching to another main agent (/agent → Coding, Deep Research, etc.) closes that window.

If the dedicated window is already open, other AdaL sessions share it instead of opening a new one.

Headless / Scripted Browser Use​

Run Browser Use from CI, shell scripts, or any automation workflow. Combine --agent-mode browser-use with the standard headless flags:

# Print the final answer to stdout
adal -q "summarize the visible text on https://example.com" --agent-mode browser-use

# Stream structured output as NDJSON
adal -q "fill the login form with test@example.com" --agent-mode browser-use -o stream-json

This uses the same agent runtime as the interactive CLI, so behavior is consistent between local development and CI.

Safety Notes​

Browser Use can interact with real websites and real accounts, so use it thoughtfully.

  • Use with caution. AdaL performs most browser actions automatically without asking for confirmation.
  • Prefer test accounts and staging environments.
  • Avoid entering passwords, payment details, or private information unless you explicitly intend to.
  • If a page shows a browser dialog or gets stuck, you may need to manually dismiss it.
  • You are responsible for how Browser Use is used. Make sure your use complies with the terms of service of any website you visit and with all applicable laws. AdaL is provided as-is, without warranty of any kind, and AdaL is not liable for any actions taken through Browser Use.

Related: Agents & Modes (/agent) · Headless Mode · Slash Commands