browser-use

browser-use

Automated browser control via the browser-use CLI. Navigate pages, fill forms, click elements, take screenshots, and extract content — all from the command line. On most installs it is backed by Playwright Chromium under the hood — but not on all of them; verify before relying on it.

⚠️ Verify the interface before trusting this doc. On some machines this CLI does not launch its own Playwright browser — it attaches over CDP to an already-running Chromium/Brave, and there is no --profile flag. Run browser-use skill show (or --doctor) to confirm the real interface first. If it attaches over CDP: persistence only happens if you launch the browser with your own --user-data-dir on a debug port; modern Brave/Chrome (136+) refuses remote debugging on the default profile, so use a dedicated user-data-dir and never chase the chrome://inspect toggle.

Prerequisites

• Python 3.11+ (3.12 recommended)
• A Python virtual environment with browser-use installed (pip install browser-use)
• Playwright Chromium installed (python -m playwright install chromium)
• A graphical display when running headed (Linux: an X / Wayland session; macOS / Windows: native window)

Environment Setup

Every browser-use command needs the venv activated. On Linux you also need to point DISPLAY at the active session and (optionally) tell Playwright where its browsers live.

# activate the venv that has browser-use installed
source <path/to/venv>/bin/activate

# Linux only — point at the active X/Wayland display
export DISPLAY=:0           # adjust to match the running session (:0, :1, ...)

# optional — pin the Playwright browser cache location
export PLAYWRIGHT_BROWSERS_PATH="$HOME/.playwright"

macOS and Windows do not need DISPLAY; the headed flag just opens a native window.

Quick Reference

# Open a URL (headed — visible window)
browser-use --headed open <url>

# Open headless (no visible window)
browser-use open <url>

# See numbered interactive elements on current page
browser-use state

# Click element by index
browser-use click <index>

# Type into an input field by index
browser-use input <index> "text"

# Take a screenshot
browser-use screenshot output.png

# Scroll the page
browser-use scroll [up|down]

# Go back
browser-use back

# Press keys (e.g. Enter, Tab)
browser-use keys Enter

# Select from dropdown
browser-use select <index> "value"

# Extract page content
browser-use extract

# Close the browser
browser-use close