tutorials · 27 lessons

Learn BrowserBash, one runnable lesson at a time

Hands-on, in-depth tutorials for natural-language browser automation. Every flag, engine, provider and local-model option, explained with commands you can run as you read. Install once with npm i -g browserbash-cli and follow along — no account needed. Prefer prose? Browse the blog →

tutorial 12026-01-06

Install BrowserBash CLI: the complete setup guide

Install BrowserBash CLI on macOS, Linux, or Windows: Node and Chrome prerequisites, npm global install, verifying, a first sanity run, and uninstall.

tutorial 22026-01-09

Your first BrowserBash run: browser automation in plain English

A hands-on browserbash tutorial: write a plain-English objective, watch the AI agent drive real Chrome, and read the verdict plus extracted values.

tutorial 32026-01-13

The browserbash run command, every option explained

A hands-on deep dive on the browserbash run command: writing good objectives plus --model, --headless, --timeout, --record, and structured output.

tutorial 42026-01-16

Every BrowserBash CLI flag, explained with examples

A reference tutorial to BrowserBash CLI flags across run, testmd, dashboard, and connect — every flag in a table with a runnable example each.

tutorial 52026-01-20

Stagehand vs builtin engine in BrowserBash: when to use each

Hands-on guide to the BrowserBash engine choice: Stagehand vs builtin, the --engine flag, why grids auto-use builtin, and traces on builtin runs.

tutorial 62026-01-23

Run browser automation locally with BrowserBash

A hands-on local browser automation CLI tutorial: drive your own Chrome with BrowserBash, headed vs headless, zero API keys, fully on-device.

tutorial 72026-01-27

Attach BrowserBash to any browser over CDP

Configure a browserbash cdp endpoint with --provider cdp and --cdp-endpoint to attach the AI agent to docker Chrome or a Playwright-managed browser.

tutorial 82026-01-30

Cloud browsers with BrowserBash and Browserbase

A hands-on browserbase cli tutorial: set your keys, run with --provider browserbase, and learn exactly when cloud browsers beat local Chrome.

tutorial 92026-02-03

Run AI browser tests on LambdaTest with BrowserBash

Hands-on lambdatest ai testing cli tutorial: set LT keys, run --provider lambdatest with BrowserBash, go --headless, and watch recordings in the LT dashboard.

tutorial 102026-02-06

Run AI browser tests on BrowserStack with BrowserBash

A hands-on browserstack ai testing tutorial: wire your BrowserStack keys, run --provider browserstack, and drive cross-browser AI tests with BrowserBash.

tutorial 112026-02-10

Free local browser automation with Ollama and BrowserBash

A hands-on Ollama browser automation tutorial: pull a model, let BrowserBash auto-resolve it, tune OLLAMA_MODEL and OLLAMA_BASE_URL, and pick the right size.

tutorial 122026-02-13

Use any model via OpenRouter in BrowserBash

An openrouter browser automation tutorial: set OPENROUTER_API_KEY, pin openrouter/<vendor>/<model>, run free hosted models, and keep cost under control.

tutorial 132026-02-17

Drive a browser with Claude using BrowserBash

Claude browser automation tutorial: wire ANTHROPIC_API_KEY into BrowserBash, run claude-opus-4-8 on the builtin engine, and route through a gateway.

tutorial 142026-02-20

Choosing the right model for BrowserBash

Pick the best model for browser automation in BrowserBash: how auto resolution works, local vs hosted trade-offs, and matching model size to task difficulty.

tutorial 152026-02-24

BrowserBash agent mode: NDJSON output for CI and AI agents

Learn BrowserBash agent mode: the --agent NDJSON event schema, how to parse run_end, exit codes, and wire browser runs into CI and a coding agent.

tutorial 162026-02-27

BrowserBash exit codes and CI gating, explained

A hands-on tutorial to BrowserBash exit codes — what 0/1/2/3 mean, how to fail a pipeline correctly, and how to combine --agent with --timeout.

tutorial 172026-03-03

Writing committable markdown tests with BrowserBash

Hands-on tutorial on markdown browser tests: write a _test.md file, run testmd, read Result.md, and compose suites with @import — no selectors needed.

tutorial 182026-03-06

Variables and masked secrets in BrowserBash tests

Hands-on guide to BrowserBash variables and secrets: use {{variables}} templating and secret-marked vars masked as ***** so credentials never leak.

tutorial 192026-03-10

Record video, screenshots and traces with BrowserBash

Hands-on BrowserBash record video tutorial: capture .webm session video, screenshots and a Playwright trace with --record, then open every artifact.

tutorial 202026-03-13

The free local BrowserBash dashboard

A hands-on browserbash dashboard tutorial: open the local dashboard at localhost:4477, inspect the on-disk run store, use --dashboard on a run, and --clear it.

tutorial 212026-03-17

Connect and upload runs to the BrowserBash cloud dashboard

A hands-on browserbash connect upload tutorial: link a key, push runs with --upload, keep privacy opt-in, and share 15-day run pages.

tutorial 222026-03-20

Run BrowserBash in GitHub Actions

Browser automation in GitHub Actions with BrowserBash: a full workflow YAML covering install, --agent --headless, exit-code gating, and artifact upload.

tutorial 232026-03-24

Run BrowserBash in a Jenkins pipeline

A hands-on tutorial for ai browser tests jenkins: a declarative Jenkinsfile stage, headless Chrome, exit-code gating, and archiving .webm recordings.

tutorial 242026-03-27

Headless mode and timeouts in BrowserBash

Hands-on browserbash headless tutorial: run --headless on servers and CI, tune --timeout, and debug runs that only fail when the browser is hidden.

tutorial 252026-03-31

Writing reliable plain-English objectives for BrowserBash

Hands-on tutorial on writing natural language test objectives for BrowserBash: be specific, store values, verify, and break long flows into reliable steps.

tutorial 262026-04-03

Extract and store data from any page with BrowserBash

A hands-on ai data extraction cli tutorial: write objectives that store named values, read final_state, and pull structured data without selectors.

tutorial 272026-04-07

Automate a login-to-checkout flow with BrowserBash

Automate login and checkout as one markdown test with BrowserBash. Drive real Chrome, mask secrets, and verify Thank you for your order on the local model path.