https://github.com/testdriverai/playground
https://github.com/testdriverai/playground
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/testdriverai/playground
- Owner: testdriverai
- Created: 2024-12-10T20:48:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-22T19:33:20.000Z (about 1 year ago)
- Last Synced: 2025-04-24T03:04:12.667Z (10 months ago)
- Size: 11.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TestDriver: Bot Playground
Automate and scale QA with agentic users.
[Docs](https://docs.testdriver.ai) | [Website](https://testdriver.ai) | [GitHub Action](https://github.com/marketplace/actions/testdriver-ai) | [Join our Discord](https://discord.gg/a8Cq739VWn)
---
Ask [@testdriverbot](https://github.com/testdriverbot) to test your app within any issue or pull request! TestDriver is an agentic user tester, it has access to the entire OS and uses computer vision with mouse and keyboard control to simulate a real user.
Just tag [@testdriverbot](https://github.com/testdriverbot) and include a markdown list of tasks. TestDriver will attempt your tasks and generate a regression test.
You can try it right now [in this repo](https://github.com/testdriverai/bot-playground/pull/1).
# Overview
Tag [@testdriverbot](https://github.com/testdriverbot) in your repo and provide a markdown list of steps to take.
```sh
@testdriverbot
1. open youtube.com
2. search for rick astley
3. click the first video
4. verify the video is playing
```
TestDriver will spawn an ephemeral Windows VM with Chrome launched and attempt to complete your task. This might take a few minutes! TestDriver will make a comment and ping you when it's done.
You can click on the animated GIF to see the full test recording.
# FAQ
## How do I turn this into a regression test?
Add the `/save` command and TestDriver will generate a YML file. Then, use [our GitHub action](https://docs.testdriver.ai/continuous-integration/github-setup) to re-run this test on every PR, commit, or merge!
```yml
- uses: testdriverai/action@main
with:
key: ${{ secrets.TESTDRIVER_API_KEY }}
prompt: 1. /run testdriver/test.yml
prerun: |
cd $env:TEMP
npm init -y
npm install dashcam-chrome
Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "--start-maximized", "--load-extension=$(pwd)/node_modules/dashcam-chrome/build", "${{ env.WEBSITE_URL }}"
exit
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
FORCE_COLOR: "3"
```
## Can this validate PRs?
Yes! You need to deploy to GitHub pages, Vercel preview, or upload an artifact first. Then, have TestDriver download that artifact as part of the [prerun script](https://docs.testdriver.ai/continuous-integration/prerun-scripts).
## Does this work for private repos?
Yes, just add @testdriverbot as a collaborator.