traceloom run
Submit your Playwright tests for distributed execution across EC2 Spot workers in your AWS account. Traces are collected for every test.
Usage
traceloom run [options]Examples
Run all tests using your project config:
traceloom runRun with a specific file pattern and 4 workers:
traceloom run --pattern "tests/e2e/**/*.spec.ts" --workers 4Run with verbose output and a 60-minute timeout:
traceloom run --verbose --timeout 60Options
| Flag | Description | Default |
|---|---|---|
-w, --workers <n> | Maximum parallel workers | — |
--pattern <glob> | Test file glob pattern (e.g. "tests/**/*.spec.ts") | From import |
-t, --timeout <minutes> | Maximum run duration in minutes | 30 |
-i, --import <testId> | Specific imported test suite to use | Auto-detect |
-c, --customer <id> | Customer ID (overrides config) | — |
-p, --project <id> | Project ID (overrides config) | — |
--api-url <url> | API base URL | — |
-v, --verbose | Print detailed polling info | Off |
--no-color | Disable color output | — |
Exit Codes
The exit code can be used to fail CI pipelines on test failures. See CI/CD Integration for examples.
| Code | Meaning |
|---|---|
0 | All tests passed |
1 | One or more tests failed |
2 | Error (API failure, timeout, missing config) |
Interrupting a Run
Press Ctrl+C to interrupt a run. TraceLoom handles SIGINT gracefully
and performs a clean shutdown.
Next Steps
- traceloom runs — view run history and detailed results from the terminal
- CI/CD Integration — use
traceloom runin GitHub Actions - CLI Overview — see all available commands
Last updated: April 2026