tamash-playgen

Early release, published primarily to reserve the package name. init itself is real and fully working (see Quickstart below) — but this is not yet the full TAMASH-PlayGen vision. AI-driven test generation (understanding your application and existing tests to write new ones) is still on the roadmap.

tamash-playgen scaffolds a ready-to-use Playwright test project — with tamash-playwright's AI-powered self-healing wired in from the start, following a small, agent-friendly project structure instead of a Selenium-style framework.

It's the first step of TAMASH's lifecycle:

Generate → Execute → Heal → Maintain

tamash-playgen handles the starting point — a working repo structure, ready for tests. tamash-playwright takes over from there: when a test breaks, it heals the selector, and apply-heals can turn that into a permanent fix and open a PR.

Quickstart

npx tamash-playgen init my-app
cd my-app
npm install
npx playwright install
cp .env.example .env   # then add your AI provider's API key
npm test

Or scaffold directly into the current (empty) directory:

npx tamash-playgen init

npm test runs a self-contained example test — no real app or API key needed to confirm the setup works before you point it at anything real.

What gets scaffolded

tests/          your tests (ui/, api/)
fixtures/       the composition root -- test/expect imported here everywhere else
pages/          Page Objects: meaningful application behavior, not Playwright wrappers
components/     helpers for complex custom UI controls (date pickers, grids, ...)
actions/        business-level workflows (loginAs, createOrder, ...)
api/            domain-specific API clients
data/           deterministic test-data builders
config/         environment-specific configuration
playwright.config.ts
AGENTS.md       guidelines for both human contributors and AI coding agents working in the repo
.env.example

The structure follows a simple principle: don't rebuild what Playwright already provides (a test runner, assertions, fixtures, parallel execution, tracing, reporting) — spend the framework's complexity budget on application knowledge instead. See AGENTS.md in a scaffolded project for the full guidelines on what belongs in each folder.

CLI

| Command | Flags | What it does | |---|---|---| | npx tamash-playgen init [name] | --force | Scaffolds a new project. With name, creates ./name/ first; without one, scaffolds into the current directory (must be empty, unless --force). |

License

Free to use, including commercially. The source code may not be copied, modified, redistributed, or resold without prior written permission.

Support

For questions or concerns, contact us at [email protected].