CLI TL;DR - SeleniumBase for Rust

The commands you reach for most, by task. Every flag here is in sbrs <command> --help; the CLI reference lists them all and CLI usage explains them.

Note

Global options (--headless, --browser, --uc, --proxy, --plugin, …) go before the command: sbrs --headless smoke https://example.com. Each command starts its own browser and closes it when it is done.

Set up#

sbrs install                      # the chromedriver that matches the installed Chromesbrs install geckodriver          # or edgedriver; a version too: sbrs install chromedriver 155sbrs doctor                       # what was found, what is missing, and how to fix itsbrs version

Open and check a page#

sbrs open https://example.com                                  # prints the titlesbrs smoke https://example.com --title-contains Example        # fails unless the title has itsbrs --headless --browser firefox smoke https://example.comsbrs --uc smoke https://example.com                            # undetected Chromesbrs deferred --url https://example.com --assert title=Example --assert "text=h1:Example Domain"

Save what a page shows#

sbrs print-pdf https://example.com -o page.pdfsbrs pdf-text https://example.com/report.pdf                   # text of a page or a PDFsbrs download-file https://example.com/file.zip -o file.zip

Write and run tests#

sbrs mkdir tests/ui                                # a runnable test suitesbrs mkfile tests/login.rs --url https://example.comsbrs test                                          # cargo test, with the sbrs options passed onsbrs test login -- --nocapture                     # tests whose name has "login"sbrs test --example NAME                           # examples/NAME.rs instead of the tests

Record, replay, translate#

sbrs record https://example.com -o actions.json    # Ctrl-C stops, or --duration 60sbrs replay actions.jsonsbrs run-scenario --file login.json --dashboard dashboard.htmlsbrs translate login.json es --copy                # writes login_es.json

Bring tests from other tools#

sbrs import-python test_login.py -o tests/login.rs           # SeleniumBase or Selenium Pythonsbrs import-playwright login.spec.ts -o tests/login.rs       # JavaScript, TypeScript or Pythonsbrs import-puppeteer recording.json -o tests/flow.rs        # Puppeteer or a Chrome Recorder export

Stealth and DevTools#

sbrs patch-chromedriver --path downloaded_drivers/chromedriversbrs patch-chrome --path "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"sbrs --cdp cdp --cmd Browser.getVersion                       # any DevTools Protocol commandsbrs --cdp cdp --cmd Network.setCacheDisabled --params '{"cacheDisabled":true}'

AI assistants (MCP)#

sbrs devtools                     # Chrome on 127.0.0.1:9222, prints configs for DevTools MCP serverssbrs devtools --headless --port 0sbrs-mcp --server cdp             # the MCP server on stdio: cdp, driver or sb (the default)

See MCP server for the client configurations.

Plugins#

sbrs plugin list                                   # the built-in plugins and whether they are onsbrs plugin info shieldsbrs --plugin shield open https://example.comsbrs --plugin shield --plugin-opt 'shield.level="strict"' open https://example.com

Shell#

sbrs completions zsh > ~/.zfunc/_sbrs              # bash, zsh, fish, elvish, powershellsbrs prompt                                        # Chrome's major version and the driver, for a promptsbrs encrypt "secret text"                         # prints a tokensbrs decrypt TOKEN

Tip

The same examples, in the tldr-pages format, are in contrib/tldr/ of the repository.