​
Overview

Purpose: Executes your test specifications using an AI agent in an automated browser. When to use:
  • Before deploying to validate functionality
  • In CI/CD pipelines for automated testing
  • During development to catch regressions
  • To verify fixes after bug reports
Important notes:
  • Requires your app to be running on the configured URL
  • Opens real browser instances (unless --headless)
  • Can run individual tests or entire test suites
  • Supports parallel execution for faster results
  • Streams results to dashboard when enabled

​
CLI Reference

CommandDescriptionExample
bugster runRun all available testsbugster run
bugster run auth/Run tests in specific directorybugster run auth/
bugster run --headlessRun without browser UIbugster run --headless
bugster run --parallel 5Run up to 5 tests concurrentlybugster run --parallel 5
bugster run --only-affectedRun only tests for changed filesbugster run --only-affected

​
Execution Flags

FlagDescriptionExample
--headlessRun tests in headless mode (no browser UI)--headless
--silentRun in silent mode (less verbose output)--silent
--verboseEnable verbose output for debugging--verbose
--parallelMaximum number of concurrent tests (default: 3)--parallel 8
--max-concurrentAlias for —parallel--max-concurrent 5
--limitMaximum number of tests to run--limit 10
--browserBrowser to use for tests--browser chromium

​
Filtering Flags

FlagDescriptionExample
--only-affectedOnly run tests for affected files/directories--only-affected
--base-urlOverride base URL from config--base-url https://staging.myapp.com

​
Output Flags

FlagDescriptionExample
--outputSave test results to JSON file--output results.json
--stream-resultsStream results to dashboard (default: true)--stream-results
--no-stream-resultsDisable streaming to dashboard--no-stream-results

​
Common Usage Patterns

Use CaseCommandDescription
Local developmentbugster runRun all tests with browser visible
CI/CD pipelinebugster run --headless --stream-resultsAutomated testing in CI
Quick validationbugster run --limit 5 --parallel 3Run subset of tests quickly
Staging testingbugster run --base-url https://staging.app.comTest against staging environment
Debuggingbugster run auth/ --verboseDebug specific test category
Performance testingbugster run --parallel 10 --headlessMaximum speed execution
Pro Tips:
  • Use --only-affected in PR workflows to test only changed functionality
  • --parallel significantly speeds up execution but uses more resources
  • --output is useful for generating test reports in CI/CD
  • Browser videos are automatically recorded for failed tests