Skip to main content
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
--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.