@vibetestq/tamash-agent

The TAMASH GenEx Agent. You write test cases in plain English; it runs them in a real browser and turns the ones that pass into Playwright tests.

• Run plain-English test cases (Markdown or YAML), several at a time.
• Generate a Playwright project from the cases that pass: page objects, fixtures and tests. What you wrote yourself is never overwritten.
• Explore an app, read-only, and get a report of its screens, issues, accessibility and the screens no test covers.

Requires Node 22.12 or later, Chrome or Edge (or npx playwright install chromium), and a TAMASH project that includes the GenEx Agent.

Set up

npm i -D @vibetestq/tamash-agent
npx tamash login                                          # signs you in and saves your project in tamash.config.json
npx tamash init --qa --app=shop --url=https://shop.example.com

init creates qa/scenarios/shop/. Put the app's sign-in in qa/scenarios/shop/app.env (it stays out of git), and commit tamash.config.json.

Write a test case

# Admin can add a new employee
Log in using the admin credentials
Click on the text 'PIM'
Click on the 'Add' button
Fill the 'First Name' field with 'Jane'
Click on the 'Save' button
Verify the 'Personal Details' heading is visible

Save it as qa/scenarios/shop/<module>/<name>.md.

Run

npx tamash run --app=shop --workers=4          # run every test case
npx tamash run --app=shop --workers=4 --pom    # and write Playwright tests from the ones that pass (qa/automation)
npx tamash explore --app=shop                  # explore the app, read-only

In CI

Add one secret, TAMASH_ACCESS_TOKEN: a service token of your project (portal: Administration, Projects).

Help

Every command, setting and limit is in the TAMASH help: https://tamash.vibetestq.com/help/genex-agent

License

Commercial: a TAMASH license for your organization is required (LICENSE). Questions: [email protected]