Quickstart

Install @ulpi/browse and run your first browsing session in under 5 minutes.

Install

npm install -g @ulpi/browse

Or run directly with npx:

npx @ulpi/browse goto https://example.com

Your first session

# Navigate to a page
browse goto https://example.com

# Get interactive elements with numbered refs
browse snapshot -i
# Output:
# @e1 [link] "More information..."

# Click using the ref
browse click @e1

# Extract the page text
browse text

The @ref workflow

Every snapshot assigns refs (@e1, @e2, ...) to elements. Use refs as selectors in any command — no CSS selector construction needed.

$ browse snapshot -i
@e1 [button] "Submit"
@e2 [link] "Home"
@e3 [textbox] "Email"

$ browse fill @e3 "user@example.com"
Filled @e3

$ browse click @e1
Clicked @e1 "Submit"

Next steps

Installation guide for detailed setup options
CLI Reference for all 121 commands
AI Agent Integration to set up with Claude Code, Cursor, or Cline

On this page

Install Your first session The @ref workflow Next steps