Quickstart

Get up and running with TestBro in under 5 minutes.

1. Install the CLI

npm install -g @testbro/cli

Verify the installation:

testbro --version

2. Authenticate

Get an API token from the TestBro dashboard, then log in:

testbro login --token <your-api-token>

You should see a success message confirming your identity.

3. Run the quickstart wizard

The quickstart command creates a demo project with sample test cases:

testbro quickstart

This will:

  • Verify your authentication
  • Create a "My First Project" with sample test cases
  • Generate a test-bro.config.json configuration file
  • Set the project as your active project

4. Run your first test

Run the sample tests against httpbin.org:

testbro run --mode ai

The AI agent will open a browser, navigate to the target URL, and execute each test step. You will see real-time progress and a pass/fail summary.

5. Run a custom test

Try testing any website with a plain English description:

testbro run --url https://example.com --description "Verify the page loads and displays a heading" --mode ai

6. Generate tests from a file

Create a file describing your feature (e.g., login-feature.md), then generate and run tests:

testbro run --url https://your-app.com --file login-feature.md --mode ai --project <project-id>

Next Steps