CLI reference

The full reference for every bl command, argument, and flag — generated from bl v0.1.1. 110 commands across 9 groups.

See the CLI ↔ MCP mapping for how each command lines up with the agent-facing MCP tools.

Command	Description
`bl go`	Go to a URL and print page info
`bl back`	Navigate back in browser history
`bl forward`	Navigate forward in browser history
`bl reload`	Reload the current page
`bl wait`	Wait for an element, URL, text, page load, or JS condition
`bl wait fn`	Wait until a JS expression returns truthy
`bl wait load`	Wait until the page is fully loaded
`bl wait text`	Wait until text appears on the page
`bl wait url`	Wait until the page URL contains a substring

Interaction

Command	Description
`bl click`	Click an element (optionally navigate to URL first)
`bl dblclick`	Double-click an element
`bl hover`	Hover over an element by CSS selector
`bl type`	Type text into an element (optionally navigate to URL first)
`bl fill`	Clear an input field and type new text
`bl press`	Press a key on a specific element or the focused element
`bl keys`	Press a key or key combination
`bl select`	Select an option in a <select> element
`bl check`	Check a checkbox or radio button
`bl uncheck`	Uncheck a checkbox
`bl focus`	Focus an element
`bl scroll`	Scroll the page or an element
`bl scroll into-view`	Scroll an element into view
`bl drag`	Drag from one element to another
`bl mouse`	Mouse control (click, move, down, up)
`bl mouse click`	Click at coordinates or current position
`bl mouse down`	Press a mouse button down
`bl mouse move`	Move the mouse to coordinates
`bl mouse up`	Release a mouse button
`bl upload`	Set files on an input[type=file] element

Command	Description
`bl url`	Get the current page URL
`bl title`	Get the current page title
`bl text`	Get text content of the page or an element
`bl html`	Get HTML content of the page or an element
`bl attr`	Get an HTML attribute value from an element
`bl value`	Get the current value of a form element
`bl count`	Count matching elements
`bl find`	Find elements by CSS selector or semantic locator
`bl find alt`	Find element by alt attribute
`bl find label`	Find input by associated label text
`bl find placeholder`	Find element by placeholder attribute
`bl find role`	Find element by ARIA role
`bl find testid`	Find element by data-testid attribute
`bl find text`	Find element by text content
`bl find title`	Find element by title attribute
`bl find xpath`	Find element by XPath expression
`bl map`	Map interactive page elements with @refs
`bl a11y-tree`	Get the accessibility tree of the current page
`bl is`	Check element state (visible, enabled, checked, actionable)
`bl is actionable`	Check actionability of an element (Visible, Stable, ReceivesEvents, Enabled, Editable)
`bl is checked`	Check if a checkbox or radio is checked
`bl is enabled`	Check if an element is enabled
`bl is visible`	Check if an element is visible on the page
`bl pages`	List all open browser pages
`bl frames`	List all child frames (iframes) on the page
`bl frame`	Find a frame by name or URL substring

Command	Description
`bl screenshot`	Capture a screenshot (optionally navigate to URL first)
`bl pdf`	Save page as PDF
`bl record`	Record browser sessions (screenshots and snapshots)
`bl record chunk`	Manage recording chunks
`bl record chunk start`	Start a new chunk within the current recording
`bl record chunk stop`	Package current chunk into a ZIP file (recording stays active)
`bl record group`	Manage recording groups
`bl record group start`	Start a named group in the recording
`bl record group stop`	End the current recording group
`bl record start`	Start a recording
`bl record stop`	Stop recording and save
`bl highlight`	Highlight an element with a red outline for 3 seconds

Command	Description
`bl cookies`	Manage browser cookies
`bl cookies clear`	Clear all cookies
`bl storage`	Export or restore browser state (cookies, localStorage, sessionStorage)
`bl storage restore`	Restore browser state from a JSON file
`bl download`	Manage browser downloads
`bl download dir`	Set the download directory
`bl dialog`	Handle browser dialogs (alert, confirm, prompt)
`bl dialog accept`	Accept a dialog (optionally with prompt text)
`bl dialog dismiss`	Dismiss a dialog
`bl content`	Replace the page HTML content
`bl diff`	Compare current state vs previous
`bl diff map`	Compare current page elements vs last map
`bl viewport`	Get or set the browser viewport size
`bl window`	Get or set the OS browser window size, position, or state
`bl media`	Override CSS media features
`bl geolocation`	Override the browser geolocation

Command	Description
`bl eval`	Evaluate a JavaScript expression (optionally navigate to URL first)
`bl sleep`	Pause execution for a number of milliseconds

Command	Description
`bl start`	Start a browser session. Without arguments, launches a local browser. With a URL argument, connects to a remote BiDi WebSocket endpoint.
`bl stop`	Stop the browser session
`bl page`	Manage browser pages (new, close, switch)
`bl page close`	Close a browser page by index (default: current page)
`bl page new`	Open a new browser page
`bl page switch`	Switch to a browser page by index or URL substring
`bl daemon`	Manage the browserlane daemon (background browser process)
`bl daemon start`	Start the browserlane daemon
`bl daemon status`	Show daemon status
`bl daemon stop`	Stop the browserlane daemon

Command	Description
`bl mcp`	Start the Model Context Protocol (MCP) server.
`bl add-mcp`	Register the browserlane MCP server with a coding agent (claude, claude-desktop, cursor, vscode, codex)
`bl add-skill`	Install browserlane browser skill for Claude Code

Command	Description
`bl install`	Download Chrome for Testing and chromedriver
`bl is-installed`	Check if Chrome and chromedriver are installed (exit 0 = yes, exit 1 = no)
`bl paths`	Print browser and cache paths
`bl version`	Print the version number
`bl completion`	Generate the autocompletion script for bl for the specified shell. See each sub-command's help for details on how to use the generated script.
`bl completion bash`	Generate the autocompletion script for the bash shell.
`bl completion fish`	Generate the autocompletion script for the fish shell.
`bl completion powershell`	Generate the autocompletion script for powershell.
`bl completion zsh`	Generate the autocompletion script for the zsh shell.

Low-level probes for debugging the browser/WebDriver stack — not part of the everyday workflow.

Command	Description
`bl launch-test`	Launch browser via chromedriver and print BiDi WebSocket URL
`bl bidi-test`	Launch browser, connect via BiDi, send session.status
`bl ws-test`	Test WebSocket connection (type messages, see echoes)