Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testbrick.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Running Tests

TestBrick supports two execution modes: cloud and local.

​
Cloud execution

Click Run Test to execute in the cloud. TestBrick spins up a browser on its servers, runs every step, and returns the results with screenshots and video.
  • Uses your monthly test run credits
  • No setup required
  • Runs in a consistent environment

​
Local agent

The TestBrick local agent runs tests on your own machine for free.

​
Install

npm install -g testbrick-agent

​
Connect

testbrick-agent start
The agent connects to your TestBrick account via WebSocket. When connected, the dashboard shows “Agent Connected” and tests automatically route to your machine.

​
Benefits

  • Free — no test run credits used
  • Fast — runs on your local machine, no cloud latency
  • Access local servers — test against localhost or internal URLs

​
Test results

After a run completes, you see:
  • Step-by-step results — pass/fail status per step
  • Screenshots — captured after each step
  • Video recording — full replay of the test (cloud only)
  • Console errors — any JavaScript errors during the test
  • Network requests — all API calls made during the test

​
Test duration limits

PlanMax duration
Free5 minutes
Pro15 minutes
Team+30 minutes
If a test exceeds the time limit, remaining steps are skipped with a clear “exceeded maximum duration” message.