browser

Control a Chromium browser via CDP. Install: https://github.com/camhahu/browser

curl -fsSL https://raw.githubusercontent.com/camhahu/browser/main/packages/cli/install.sh | bash

Core Loop

browser open https://example.com  # Starts headless browser, shows outline

browser click l3                  # 1. Click by label from outline
browser text ".product-list"      # 3. Read content

browser stop                      # Always stop when finished

Prefer text over screenshots. Text is faster and more reliable. Use screenshots only when visual layout matters.

Commands

# Navigation
browser open <url>                # Open URL (auto-starts headless browser if needed)
browser navigate <url>            # Navigate current tab
browser back / forward / refresh  # History navigation
browser stop                      # Close browser

# Interaction
browser click <selector>          # Click by label, text, or CSS
browser type <text> [selector]    # Type into input (special keys: Enter, Escape, Tab)
browser hover <selector>          # Move mouse to element
browser drag <source> <target>    # Drag element to another element
browser select <selector> <value> # Select dropdown option
browser scroll <target>           # Scroll to top, bottom, or selector

# Content
browser outline                   # Show outline again (or use -a for full structure)
browser text [selector]           # Extract text content
browser screenshot [name]         # Capture screenshot (use when layout matters)

# Tabs
browser tabs                      # List all open tabs
browser use <tab-id>              # Switch to tab
browser close [tab-id]            # Close tab

# Debugging
browser console                   # Show console output
browser network                   # List network requests
browser eval <js>                 # Run JavaScript (shares scope between calls)

Navigation commands (open, click, navigate, back, forward, refresh) show an outline after completing.

For debugging or user intervention, start a headed browser with browser start --headed.

For software rendering, use browser start --headless --software-rendering. To pass through Chrome flags like Docker's --no-sandbox, use browser start --chrome-arg --no-sandbox.

Run browser --help for full command list.

Outline

Outline shows interactive elements with labels:

[l1] link "Products" [href=/products]
[l2] link "About" [href=/about]
[b3] button "Sign up"
[i4] input [type=email] [placeholder="Email"]

Selectors

browser click l3                 # Label from outline (fastest)
browser click "Sign up"          # Text match (exact first, then partial)
browser click ".btn-primary"     # CSS selector

CSS selectors: #id, .class, tag, [attr=value], parent > child

Persistent Profile

Logins, cookies, and browsing data are preserved across sessions in ~/.browser/profile/.

browser config clear-profile              # Logout, reset cookies
browser config set persistentProfile false # Disable persistence