Skip to content

Quick Start

Run tests

Navigate to any project directory and run:

testx

testx will auto-detect the language and test framework, then run your tests with formatted output.

Detect without running

testx detect

This shows what testx detected without actually running anything:

Detected: Python (pytest) — confidence 94%

Pass arguments to the test runner

Use -- to pass extra arguments through:

testx -- --filter my_test
testx -- -k "test_login"        # pytest filter
testx -- --test-threads=1       # cargo test flag

Run in a different directory

testx -p /path/to/project

Generate a config file

testx init

Creates a testx.toml with defaults you can customize.

Common workflows

# Show 5 slowest tests
testx --slowest 5

# Set a timeout (kills after 60 seconds)
testx --timeout 60

# Show raw test runner output
testx --raw

# Verbose mode (shows the detected command)
testx -v

Next steps