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)
--new-sandboxCreate a new sandbox environment for the test run.
--summary=<value>Output file where AI summary 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.