Quick Reference

Command	Description
open	Open a browser session (raw page.goto(), no stability wait)
navigate	Navigate with waitForVisualStability
close	Close the current session
sessions	List active sessions
status	Show current session state
back	Go back in history
forward	Go forward in history
reload	Reload the page
snapshot	Capture counter-annotated HTML
state	Return page URL, title, and HTML
screenshot	Save a screenshot
click	Click an element
dblclick	Double-click an element
rightclick	Right-click an element
hover	Hover over an element
input	Fill text into an input
select	Select a dropdown option
scroll	Scroll the page or element
extract	Extract structured data
press	Press a keyboard key
type	Type text character by character
get-text	Get element text content
get-value	Get element value
get-attrs	Get element attributes
get-html	Get page or element HTML
tabs	List open tabs
tab-new	Open a new tab
tab-switch	Switch to a tab by index
tab-close	Close a tab
cookies	List cookies
cookie-set	Set a cookie
cookies-clear	Clear all cookies
cookies-export	Export cookies to file
cookies-import	Import cookies from file
eval	Evaluate JavaScript in page
wait-for	Wait for text on page
wait-selector	Wait for a CSS selector

Global Flags

Flag	Description
--session <id>	Target a specific session
--name <namespace>	Set the selector cache namespace
--headless	Run in headless mode
--connect <url>	Connect via CDP URL

Navigation

opensteer open --name my-project --url https://example.com
opensteer navigate --url https://example.com/page
opensteer back
opensteer forward
opensteer reload

open performs raw page.goto() without stability wait. navigate includes waitForVisualStability. Use open for initial session creation, navigate for subsequent page loads.

Observation

opensteer snapshot action
opensteer snapshot extraction
opensteer state
opensteer screenshot --path ./screenshot.png

Actions

opensteer click --element 3
opensteer click --description "login-button"
opensteer input --description "email-field" --text "user@example.com"
opensteer select --description "country" --value "US"
opensteer scroll --direction down --amount 800

Extraction

Counter-based extraction (preferred):

opensteer snapshot extraction
opensteer extract --description "product" --schema '{"name": "string", "price": "string"}'

Array extraction:

opensteer extract --description "results" --schema '{"items": [{"title": "string", "url": "string"}]}'

Note: AI-based extraction requires @ai-sdk/* packages and a configured LLM API key.

Keyboard

opensteer press Enter
opensteer type "search query"

Element Info

opensteer get-text --element 5
opensteer get-value --description "email-input"
opensteer get-attrs --selector "#main"
opensteer get-html

Tabs

opensteer tabs
opensteer tab-new --url https://example.com
opensteer tab-switch --index 1
opensteer tab-close

Cookies

opensteer cookies
opensteer cookie-set --name "session" --value "abc123" --domain "example.com"
opensteer cookies-clear
opensteer cookies-export --path ./cookies.json
opensteer cookies-import --path ./cookies.json

Environment Variables

Variable	Description
OPENSTEER_SESSION	Route commands to a specific session
OPENSTEER_NAME	Default selector namespace
OPENSTEER_CLIENT_ID	Non-interactive binding identity
OPENSTEER_DEBUG	Enable debug logging
OPENSTEER_HEADLESS	Run headless
OPENSTEER_CONNECT_URL	CDP connection URL

See Environment Variables for the full list.