> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdriver.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# /run

> Run a test file from a file.

## Description

The `/run` command is used to execute a test file from a specified file. This command performs each step defined in the test file and outputs the results.

## Usage

```bash theme={null}
npx testdriverai@latest edit <filename.yaml>
/run [other-filename.yaml] # if no path is present it will run the `filename.yaml`
```

## Example usage

```bash theme={null}
testdriverai edit
> /run helloworld.yaml
```

This command runs the `helloworld.yaml` test file, executing each command in the file sequentially.

<Warning>
  The `helloworld.yaml` file needs to be present in the present directory. If
  its present outside, need to specify the relative path like
  `../snippets/helloworld.yaml`
</Warning>

## Behavior

* TestDriver will execute the test file, performing each command as defined in the file.
* If the test completes successfully, the program will exit with code `0`.
* If any failures occur during the test, the program will output the errors and exit with code `1`.

## Protips

* Ensure the test file path is correct and accessible before running the command.
* Use descriptive filenames for your test files to make them easier to identify.

## Gotchas

* Any errors in the test file (for example, invalid commands or missing arguments) will cause the test to fail.

## Notes

* The `/run` command is ideal for executing pre-created test files in an interactive session.
* Use this command to validate and debug your test files during development.