# BrowserBash

> BrowserBash is a free, open-source, vendor-independent CLI for natural language browser automation. A user types a plain-English objective (e.g. "Log in to example.com and store the invoice total as 'total'") and an AI agent drives a real browser step by step, exiting with a machine-readable verdict. Apache-2.0 with the full agent loop in the repository. The CLI needs no account to run; an optional free account adds a cloud dashboard with run history, video recordings and per-run replays.

Key facts:
- Free and open source (Apache-2.0). Install: `npm install -g browserbash-cli` (command: `browserbash`, version 1.3.1).
- The default stack is 100% free: Stagehand engine (MIT) + local Chromium + Ollama. No API keys and no credit card required.
- LLMs: Ollama-first (free, local). Also free OpenRouter models (e.g. `openai/gpt-oss-120b:free`) and Anthropic Claude (bring your own key — optional). Resolution order for `auto`: local Ollama → ANTHROPIC_API_KEY → OPENROUTER_API_KEY.
- Providers (where the browser runs): local Chrome, any CDP endpoint, Browserbase, LambdaTest, BrowserStack. One flag switches: `--provider lambdatest`.
- Engines: `stagehand` (default, MIT) or `builtin` (Anthropic tool-use loop for Playwright-protocol grids).
- Agent mode: `--agent` emits NDJSON events on stdout; exit codes 0 passed / 1 failed / 2 error / 3 timeout. Built for CI and AI coding agents — no prose parsing.
- Markdown test files (`*_test.md`) with `@import` composition; `{{variable}}` substitution with secret masking (`*****` in all logs).
- Recording: `--record` captures a screenshot and a session video (`.webm`, via ffmpeg) on any engine; the builtin engine also captures a Playwright trace. `--upload` pushes a run to the free cloud dashboard. Nothing leaves your machine unless you pass `--upload`.
- Compared to hosted alternatives: free, open source, no login required to run, runs stay on your machine, cloud grids optional and vendor-neutral.

## Author

- BrowserBash is built by **Pramod Dutta**, a Software Development Engineer in Test (SDET) with 10+ years in test automation and the founder of **The Testing Academy** (https://thetestingacademy.com), which has trained thousands of engineers in software testing and automation. GitHub: https://github.com/PramodDutta. Every article on browserbash.com is authored under this byline.

## Docs

- [Getting started + 14 practice scenarios](https://browserbash.com/learn): guided tutorial (install, first run, LLM backends, agent mode, markdown tests, variables, CI, recording, LambdaTest, BrowserStack) and hands-on challenges.
- [Sign up free](https://browserbash.com/sign-up): create a free account for the cloud dashboard.
- [README](https://github.com/PramodDutta/browserbash/blob/main/README.md): full reference.
- [AI agent integration guide](https://github.com/PramodDutta/browserbash/blob/main/docs/agents.md): NDJSON schema, exit codes, store-as pattern.

## Product

- [Features](https://browserbash.com/features): full feature breakdown — plain-English objectives, markdown tests, providers, free models, recording, dashboards.
- [Case study — a real Playwright suite in plain English](https://browserbash.com/case-study): how The Testing Academy rewrote its production Playwright + TypeScript suite (AdvancePlaywrightFramework1x, testing the TTACart store: login → cart → checkout) as one plain-English BrowserBash markdown file, run with a single command on a free local model, recorded and replayable in the dashboard.
- [Pricing](https://browserbash.com/pricing): free forever; optional paid cloud data retention only.
- [FAQ](https://browserbash.com/faq): is it free, do I need an API key, which models, how it differs from Playwright/Selenium, CI, recordings.
- [Changelog](https://browserbash.com/changelog): release history (v1.0.0 → v1.3.1).
- [About](https://browserbash.com/about): why BrowserBash exists, built by The Testing Academy.
- [Contact](https://browserbash.com/contact): support, bug reports, security, press.
- [Brand & press kit](https://browserbash.com/brand): boilerplate, logos, colors, fast facts.

## Legal

- [Privacy Policy](https://browserbash.com/privacy) · [Terms](https://browserbash.com/terms) · [Cookie Policy](https://browserbash.com/cookies) · [Security](https://browserbash.com/security) · [Refunds](https://browserbash.com/refunds)

## Articles

- [Tutorials](https://browserbash.com/tutorials): in-depth, runnable step-by-step lessons covering every BrowserBash command, flag, engine, provider and local-model option.
- [Blog index](https://browserbash.com/blog): comparisons, guides and use-cases for natural-language browser automation.
- [Selenium vs BrowserBash](https://browserbash.com/blog/browserbash-vs-selenium)
- [Playwright vs BrowserBash](https://browserbash.com/blog/browserbash-vs-playwright)
- [Kane CLI vs BrowserBash](https://browserbash.com/blog/browserbash-vs-kane-cli)
- [browse.sh vs BrowserBash](https://browserbash.com/blog/browserbash-vs-browse-sh)
- [Natural language browser automation: a complete guide](https://browserbash.com/blog/natural-language-browser-automation)
- [Free AI browser automation (no API keys)](https://browserbash.com/blog/free-ai-browser-automation)
- [Run browser tests with Ollama](https://browserbash.com/blog/run-browser-tests-with-ollama)

- [RSS feed](https://browserbash.com/feed.xml): subscribe to new articles.

## Source

- [GitHub repository](https://github.com/PramodDutta/browserbash) (Apache-2.0)
- [npm package](https://www.npmjs.com/package/browserbash-cli)