Quick Reference

npm install                        # install dependencies
npx playwright install chromium    # install browser
npm run dev                        # start app (dev mode)
npm run build && npm run package:electron  # build installer

OPENAI_API_KEY=sk-...
OPENAI_MODEL=gpt-4o-mini

"Generate tests for my project at /path/to/project"
"Regenerate all tests"
"Regenerate scenario-005"
"Add a test for the export CSV button"

"Run all tests"
"Run scenario-003"
"Stop tests"

"Fix the failing tests"
"Heal scenario-007"
"Why is scenario-004 failing?"
"Analyze the last run"

"Add a test scenario for password reset"
"Update scenario-002 to use the new modal selector"
"Delete scenario-011"
"Organize the plan into sections"

"What scenarios were generated?"
"Take a snapshot of https://myapp.example.com/dashboard"
"Show me the plan"

myproject/
├── autoreg.md           ← your spec (required for generation)
├── myproject.ar         ← manifest (auto-managed)
├── tests/
│   └── scenario-NNN.json
├── plans/
│   └── e2e-plan.json
└── runs/
    └── 2026-06-23T14-32/
        ├── execution.log
        └── artifacts/

{ "action": "navigate",   "selector": "https://..." }
{ "action": "click",      "selector": "[aria-label='Submit']" }
{ "action": "fill",       "selector": "[aria-label='Email']",  "value": "user@test.com" }
{ "action": "assert",     "selector": "text=Welcome",          "assertionType": "visible" }
{ "action": "wait",       "selector": ".spinner",              "timeout": 3000 }
{ "action": "screenshot"  }