Get the VS Code Extension

Turn your IDE into a powerful computer-use automation tool with our VS Code extension.
1

Install the Extension

VS Code is the recommended IDE for TestDriver. First, install the following recommended extensions:

Then, download the TestDriver extension:

Download the VS Code Extension

Get the latest version from GitHub releases.

Finally, install the extension in VS Code. You can do this by dragging and dropping the downloaded .vsix file into the VS Code window.

2

Install TestDriver

Install the TestDriver CLI globally:

npm install -g testdriverai@beta
3

Initialize Your Project

Set up your project with:

testdriverai init

This creates a .env file and sample workflow files.

4

Run TestDriver in Interactive Mode

Start TestDriver in interactive mode to create and refine tests dynamically:

testdriverai

Once started, you can use commands like /try, /undo, and /save to interactively build and test your flows.

TestDriver v5 uses the .yaml file extension for all test files. This is a breaking change from v4 which uses the .yml extension!
5

Define Your Test Steps

Use natural language to describe what you want to test. For example:

> Open Google Chrome and search for "testdriverai"

TestDriver will generate steps like:

- command: focus-application
  name: Google Chrome
- command: hover-text
  text: Search Google or type a URL
  description: main search bar
  action: click
- command: type
  text: testdriverai
- command: press-keys
  keys: [enter]
6

Refine and Save Your Test

  • Use /undo to remove the last step if needed.
  • Save your test with /save to generate a reusable YAML file.
7

Run Saved Tests

Once saved, you can run your test file anytime:

testdriverai run path/to/test.yaml

Pro Tip: Always start with interactive mode (testdriverai) to explore and refine your tests before saving them. It’s faster and more intuitive!