Plain-English objectives
Describe what you want — “log in and add the first product to the cart” — and the agent figures out the clicks and typing. No CSS selectors, no XPath, no code to maintain.
features
Everything you need to test a browser in plain English
BrowserBash turns a plain-English objective into real browser actions through an AI agent — no code, no selectors. It runs on free local models with zero API keys, drives real browsers, and fits straight into your test suite and CI.
Write tests the way you’d describe them
Markdown test files
Save your scenarios as readable *_test.md files and compose them with @import, so shared setup and reusable flows stay in one place across your whole suite.
Variables & secret masking
Template values into your tests with variables, and pass credentials as secrets that are automatically masked in logs and output — so nothing sensitive leaks into your run history.
Run it anywhere, for free
Free models, zero keys
Run on free local models with Ollama or free models on OpenRouter — no API keys, no credit card. Want more power? Bring your own Anthropic or OpenRouter key whenever you like.
Real browsers & providers
Drive a real local Chrome, any CDP endpoint, or cloud grids like Browserbase, LambdaTest, and BrowserStack — the same test runs everywhere, from your laptop to a remote browser farm.
Open source & free
BrowserBash is free and open source under Apache-2.0. Install with npm install -g browserbash-cli, read the source, and audit exactly what it does.
Ship it into CI and see every run
Agent mode & CI
Stream structured NDJSON output for tooling and agents, and rely on clean CI exit codes (0/1/2/3) to gate your pipeline on real pass/fail signals.
Session recording
Add --record to capture video and screenshots of a run, so you can see exactly what the agent did and share a clear repro when something breaks.
Local dashboard
Run the dashboard command to open a free, fully local web dashboard — browse your runs on your own machine, no account and nothing uploaded.
Cloud dashboard
Create a free account to keep run history, video recordings, and per-run replay in the cloud. Link the CLI with browserbash connect and upload a run with --upload.
Start automating in plain English
Install the open-source CLI and run your first test in minutes — no API keys, no credit card.
npm install -g browserbash-cli