testdriverai 6.0.27-canary.30c3346.0 → 6.0.27-canary.ea72c58.0

package/docs/docs.json

@@ -38,6 +38,7 @@
             "group": "CLI",
             "icon": "terminal",
             "pages": [
+              "/getting-started/cli",
               "/cli/overview",
               {
                 "group": "Commands",
@@ -49,8 +50,7 @@
                 ]
               }
             ]
-          },
-          "/getting-started/vscode"
+          }
         ]
       },
       {
@@ -172,7 +172,16 @@
           "/commands/wait-for-text"
         ]
       }
-    ]
+    ],
+    "global": {
+      "anchors": [
+        {
+          "anchor": "Book a Demo",
+          "href": "https://testdriver.ai/demo",
+          "icon": "calendar"
+        }
+      ]
+    }
   },
   "modeToggle": {
     "enabled": false,
@@ -189,17 +198,13 @@
         "label": "Discord",
         "icon": "discord",
         "href": "https://discord.com/invite/cWDFW8DzPm"
-      }, 
-      {
-        "label": "Book a Demo",
-        "href": "https://form.typeform.com/to/UECf9rDx?typeform-source=docs.testdriver.ai",
-        "icon": "calendar"
-      }, {
-      "icon": "gauge-high",
+      }
+    ],
+    "primary": {
+      "type": "button",
       "label": "Dashboard",
       "href": "https://app.testdriver.ai"
     }
-    ]
   },
   "footer": {
     "socials": {

package/docs/getting-started/vscode.mdx

@@ -1,81 +1,75 @@
 ---
 title: "Install the TestDriver VS Code Extension"
-sidebarTitle: "VS Code (Beta)"
+sidebarTitle: "VS Code Setup"
 description: "Comprehensive guide to installing and setting up TestDriver for VS Code"
 icon: "file-code"
 ---
 
-<iframe
-  className="w-full aspect-video rounded-xl"
-  src="https://www.youtube.com/embed/dell_2tI6nc"
-  title="YouTube video player"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
+<Card
+  title="Get the VS Code Extension"
+  icon="link"
+  href="https://marketplace.visualstudio.com/items?itemName=testdriver.testdriver"
+>
+  Turn your IDE into a powerful computer-use automation tool with our VS Code
+  extension.
+</Card>
 
-The TestDriver VS Code extension is a powerful tool that integrates TestDriver's AI-driven test generation capabilities directly into your development environment:
-
-- Get started with example scripts for different platforms
-- Get syntax highlighting and autocompletion for [TestDriver YAML](/getting-started/editing)
-- Chat with the TestDriver agent to generate tests based on your requirements
-- Save and manage your tests directly within your project
-- Run and debug tests directly from the IDE
-- View test results and logs within the IDE
+<Steps>
+  <Step title="Initialize Your Project" stepNumber={1}>
+    Set up your project with:
 
-<Tip>The TestDriver VS Code Extension is currently in beta. If you encounter any issues or have feedback, please let us know [in Discord](https://discord.com/invite/cWDFW8DzPm)</Tip>
+    ```bash
+    npx testdriverai@latest init
+    ```
 
-<Steps>
-  <Step title="Install the VS Code Extension">
-    
-    Click the button below to install the TestDriver extension for your preferred IDE. Then, follow the setup guide and chat with TestDriver to create your first test.
-
-    <Card
-      horizontal
-      title="VS Code"
-      arrow
-      href="vscode:extension/testdriver.testdriver"
-      icon="/images/content/extension/vscode.svg"
-    ></Card>
-
-    <Card
-      horizontal
-      title="Cursor"
-      arrow
-    href="cursor:extension/testdriver.testdriver"
-    icon="/images/content/extension/cursor.svg"
-
-    > </Card>
-
-    <Card
-      horizontal
-      title="Windsurf"
-      arrow
-      href="windsurf:extension/testdriver.testdriver"
-      icon="/images/content/extension/windsurf.svg"
-    ></Card>
+    This creates a `.env` file and sample workflow files.
 
   </Step>
-  <Step title="Set Your TestDriver API Key">
-    
-    After installing the extension, you'll need to set your TestDriver API key in the extension settings.
+  <Step title="Run TestDriver in Interactive Mode" stepNumber={2}>
+    Start TestDriver in interactive mode to create and refine tests dynamically:
 
-    1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P).
-    2. Search for "Preferences: Open Settings (UI)" and select it.
-    3. In the search bar, type "TestDriver" to filter the settings.
-    4. Find the "TestDriver: Set API Key" field and enter your API key from [the TestDriver dashboard](https://app.testdriver.ai/team).
+    ```bash
+    npx testdriverai@latest
+    ```
+
+    Once started, you can use commands like `/explore`, `/run`, and `/save` to interactively build and test your flows.
 
-    <Tip>You can also set the `TD_API_KEY` environment variable in your system if you prefer not to enter it directly in the extension settings.</Tip>
-    
   </Step>
-  <Step title="Choose a Platform">
-    Click on the TestDriver icon in the sidebar to open the extension panel and choose a platform to get started (Web, Desktop, or Mobile).
+  <Step title="Define Your Test Steps" stepNumber={3}>
+    Use natural language to describe what you want to test. For example:
+
+    ```
+    > Open Google Chrome and search for "testdriverai"
+    ```
+
+    TestDriver will generate steps like:
+
+    ```yaml
+    - 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
+    ```
+
   </Step>
-  <Step title="Create Your First Test">
-    Now chat with the TestDriver agent to create your first test! Describe what you want to test, and the agent will generate the test steps for you.
+  <Step title="Refine and Save Your Test" stepNumber={4}>
+    - Save your test with `/save` to generate a reusable YAML file.
+    - Use `/run` to run the test.
   </Step>
-  <Step title="Run your test">
-    Run your test by clicking the "Run" button in the extension panel. You can view the test results and logs directly within VS Code's Test Explorer. [Learn more about running tests in VS Code](https://code.visualstudio.com/docs/debugtest/testing). 
+  <Step title="Run Saved Tests" stepNumber={5}>
+    Once saved, you can run your test file anytime:
+
+    ```bash
+    npx testdriverai@latest run path/to/test.yaml
+    ```
+
   </Step>
 </Steps>
 

package/docs/overview/comparison.mdx

@@ -13,8 +13,6 @@ TestDriver operates a full desktop environment, so it can run any application.
 | Application       | TestDriver | Playwright | Selenium |
 |:-----------------:|:---------:|:-----------:|:--------:|
 | Web Apps          | ✅            | ✅       | ✅       |
-| Mobile Apps       | ✅            | ✅       | ✅       |
-| VS Code           | ✅            | ✅       | ✅       |
 | Desktop Apps      | ✅            |          |         |
 | Chrome Extensions | ✅            |          |         |
 </div>
@@ -98,4 +96,4 @@ TestDriver currently supports Mac and Windows!
 | Windows  | ✅            | ✅       | ✅       |
 | Mac      | ✅            | ✅       | ✅       |
 | Linux    |               | ✅       | ✅       |
-</div>
+</div>

package/docs/overview/quickstart.mdx

@@ -6,106 +6,53 @@ icon: "gauge-high"
 mode: "wide"
 ---
 
+<Tip>
+  You will need a [TestDriver Pro](https://app.testdriver.ai/team) account
+  ($20/m) to complete setup.
+</Tip>
 
 <Steps>
-  <Step title="Create a TestDriver Account">
-      
-  You will need a [TestDriver Pro](https://app.testdriver.ai/team) account ($20/m) to complete setup. 
-    
+  <Step title="Install TestDriver">
+
+    Click the button below to install the TestDriver extension for your preferred IDE. Then, follow the setup guide and chat with TestDriver to create your first test.
+
     <Card
-      title="Sign Up for TestDriver"
-      icon="user-plus"
-      href="https://app.testdriver.ai/signup"
-      arrow
       horizontal
+      title="VS Code"
+      arrow
+      href="vscode:extension/testdriver.testdriver"
+      icon="/images/content/extension/vscode.svg"
     ></Card>
 
-  </Step>
-  <Step title="Set up your environment">
-      
-    Copy your API key from [the TestDriver dashboard](https://app.testdriver.ai/team), and set it as an environment variable.
-    
-    <Tabs>
-      <Tab title="macOS / Linux">
-        ```bash Export an environment variable on macOS or Linux systems
-        export TD_API_KEY="your_api_key_here"
-        ```
-      </Tab>
-      <Tab title="Windows">
-      ```powershell Export an environment variable in PowerShell
-      setx TD_API_KEY "your_api_key_here"
-      ```
-      </Tab>
-    </Tabs>
-
-    <Tip>Using VS Code, Cursor, or Windsurf? [Try our VS Code Extension (beta)](/getting-started/vscode).</Tip>
-
-  </Step>
-  <Step title="Check out an example test">
-      
-    Download the TestDriver GitHub repository and run the example test.
-
-    ```bash
-    git clone --depth 0 https://github.com/testdriverai/cli testdriverai
-    cd testdriverai/testdriver/acceptance
-    ```
+    <Card
+      horizontal
+      title="Cursor"
+      arrow
+    href="cursor:extension/testdriver.testdriver"
+    icon="/images/content/extension/cursor.svg"
 
-    TestDriver tests are written in YAML, a human-readable data format. The `prompt.yaml` file contains an example series of steps for the agent to execute.
+    > </Card>
 
-    ```yaml testdriver/acceptance/prompt.yaml
-    steps:
-      - prompt: log in
-      - prompt: add an item to the cart
-      - prompt: click on the cart icon
-      - prompt: complete checkout
-    ```
+    <Card
+      horizontal
+      title="Windsurf"
+      arrow
+      href="windsurf:extension/testdriver.testdriver"
+      icon="/images/content/extension/windsurf.svg"
+    ></Card>
 
-    Each step has a `prompt` that describes what the agent should do. The agent will use the prompt to generate [commands](/commands/assert) that make the tests faster and more reliable the next time you run the test.
+    The extension will generate most of your tests for you, but you'll probably want to customize them. [Learn more about editing tests](/getting-started/editing).
 
   </Step>
-  <Step title="Generate regression test from prompts">
+  <Step title="Run your tests in CI/CD">
     
-    Run the following command to run the test file. TestDriver will spawn a virtual machine, launch the sandbox test page, and execute the steps defined in the `prompt.yaml` file.
+    Next, use `testdriverai` to run your tests in CI/CD pipelines.
 
     ```bash
-    npx testdriverai@latest run prompt.yaml --write --heal
+    TD_API_KEY=YOUR_KEY npx testdriverai@latest run testdriver/test.yaml
     ```
 
-    The `--write` flag tells TestDriver to save any generated commands to the test file, and the `--heal` flag allows TestDriver to recover from unexpected issues during the test run.
-
-    <Tip>You can use an interactive CLI to generate test steps with the [explore command](/interactive/explore)</Tip>
-
-  </Step>
-  <Step title="Run the generated regression test">
-
-    After TestDriver has run the exploratory test, you'll see that the `prompt.yaml` file has been updated with commands generated by the agent to make the test faster and more reliable. 
-
-    ```yaml
-      version: 6.0.0
-      steps:
-        - prompt: focus chrome
-          commands:
-            - command: focus-application
-              name: Google Chrome
-        - prompt: enter a username
-          commands:
-            - command: hover-text
-              text: Username
-              description: username input field
-              action: click
-            - command: type
-              text: standard_user
-        - prompt: enter a password
-          commands:
-            - command: hover-text
-              text: Password
-              description: password input field
-              action: click
-            - command: type
-              text: secret_password
-      ```
-
-      The `--write` command tells the agent to save the generated commands to the test file, and the `--heal` command gives the agent permission to recover if something goes wrong.
+    Note that you'll want to store your API key within secret storeage. [Learn more about running tests in CI/CD pipelines](/action/setup).
 
   </Step>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "6.0.27-canary.30c3346.0",
+  "version": "6.0.27-canary.ea72c58.0",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "index.js",
   "bin": {

package/testdriver/acceptance/prompt.yaml

@@ -1,10 +1,7 @@
 version: 6.0.0
 session: 6869c3e61445b2acbbdc0018
 steps:
-  - prompt: log in
-  - prompt: add an item to the cart
-  - prompt: click on the cart icon
-  - prompt: complete checkout
+  - prompt: enter a valid username, password, and sign in
   - prompt: assert
     commands:
       - command: assert