The testdriverai CLI is the primary interface for running, managing, and debugging TestDriver scripts. It provides commands to execute tests, validate configurations, and interact with the TestDriver framework.

ā€‹
Usage

npx testdriverai@latest <command> [options]

ā€‹
Available commands

CommandDescription
runExecutes a TestDriver test.
editLaunch interactive mode.
helpDisplays help information for the CLI or a specific command.

ā€‹
Available Flags

FlagDescription
--healLaunch exploratory mode and attemp to recover if an error or failing state is encountered.
--writeOvewrite test file with new commands resulting from agentic testing
--headlessRun test without opening a browser window (useful for CI/CD environments)
--newCreate a new sandbox environment for the test run.
--summary=<value>Output file where AI summary should be saved.
--junit=<value>Output file where junit report should be saved.

ā€‹
Example usage

ā€‹
Running a test script

npx testdriverai@latest run path/to/testdriver.yaml
This command runs the specified TestDriver script, executing all steps defined in the file.

ā€‹
Initializing a new project

npx testdriverai@latest init
This command sets up a new TestDriver project in the current directory, creating the necessary folder structure and configuration files.

ā€‹
Getting help

npx testdriverai@latest help
This command displays general help information. To get help for a specific command, use: 
npx testdriverai@latest help <command>

ā€‹
Protips

  • Combine run and --headless with CI/CD pipelines to automate test execution.