BrowserBash

What is BrowserBash

BrowserBash is a free, open-source natural-language browser automation CLI. It uses an AI agent to drive a real browser from a plain-English objective. It runs on free local models (Ollama) or free OpenRouter models — no API keys or credit card required. You can optionally bring an Anthropic or OpenRouter key for other models.

How to use BrowserBash

1. Install the CLI: Run npm install -g browserbash-cli.
2. Run with a free model: Pull a local Ollama model (e.g., ollama pull qwen3) and run a command like browserbash run "Open example.com and store the heading as 'h1'".
3. Create a free account (optional): Connect once with browserbash connect --key bb_..., then use --record --upload to see every run, recording, and replay on your dashboard.

Features of BrowserBash

• Open source first: Apache-2.0 CLI on an MIT engine. The default path costs nothing and phones no one.
• --agent NDJSON mode: One JSON event per line on stdout. Exit codes 0/1/2/3 are the verdict — no prose parsing.
• Markdown tests: Committable *_test.md files with @import composition. Result.md written after every run.
• 5 providers, one flag: Same objective runs on local Chrome or a cloud grid with --provider. Adding a vendor is one file.
• Secrets stay secret: Variables marked secret are masked as ***** in every log line, remark, and summary.
• CI-ready verdicts: GitHub Actions recipe included. The process exit code is the test result.

Use Cases of BrowserBash

• End-to-end browser testing: Write one plain-English sentence to test a login, cart, checkout, or confirmation flow.
• CI/CD integration: Use NDJSON mode and exit codes to integrate with pipelines like GitHub Actions.
• Data extraction: Scrape headings, prices, or other content from websites.
• Cross-browser testing: Run the same objective on local Chrome, BrowserStack, LambdaTest, or Browserbase.

Pricing

BrowserBash is 100% free to use. The CLI can be installed and run without any signup, API keys, or credit card. A free account is optional and adds a dashboard with run history, video recordings, and per-run replays.

FAQ

Do I need an account to use BrowserBash? No. You can install the CLI and automate in seconds without signing up. A free account is optional for the dashboard.

What models can I use? By default, BrowserBash uses free local models via Ollama or free OpenRouter models. You can also bring an Anthropic or OpenRouter key to use other models.

Is BrowserBash really free? Yes. The CLI is free and open source (Apache-2.0). The default stack (local Chromium + Ollama) costs nothing. No API keys or credit card are required.

Can I use BrowserBash in CI? Yes. It supports --agent NDJSON mode with exit codes 0/1/2/3, and a GitHub Actions recipe is included.

What browsers are supported? You can use local Chrome, any CDP endpoint, Browserbase, LambdaTest, or BrowserStack.