Testorax CLI

Run autonomous AI tests against your deployed app from the terminal.

Install

npm install -g testorax

Or run on demand:

npx testorax run https://staging.example.com

Quick start

testorax login                           # save email + (optional) API key
testorax run https://example.com         # opens browser to pay, then runs
testorax run https://example.com --tier full_test
testorax whoami                          # show saved config

Commands

| Command | What it does | |---------|--------------| | testorax run <url> | Trigger a run. Opens browser to complete payment, polls for progress, prints summary. | | testorax login | Save email + optional API key to ~/.testorax/config.json | | testorax whoami | Show what's currently saved | | testorax help | Show usage |

Run flags

• --tier <name> — quick_scan (default), full_test, stress_test, launch_pack
• --email <email> — override saved email
• --no-open — print payment URL instead of opening browser (useful in headless CI)
• --json — emit one JSON status object per poll (for CI parsers)

Exit codes

• 0 — all tests passed
• 1 — at least one test failed, or the run itself errored
• 2 — invalid arguments

Config

Stored at ~/.testorax/config.json with 0600 permissions on Unix. Override the API origin with the TESTORAX_API environment variable (handy for self-hosted deployments).

Privacy

The CLI only contacts testorax.com. No telemetry to third parties.