AutoReg
AutoReg is a test automation desktop app that reads your autoreg.md spec, opens a real browser, and generates a complete E2E test suite — then runs, analyzes, and auto-heals failing tests with an AI agent.
What AutoReg does
| Step | What happens |
|---|---|
| 1. Get a spec | Generate autoreg.md for your app with the generate-autoreg AI skill |
| 2. Generate | The AI agent opens your app in a headless browser, captures live DOM snapshots, and generates scenario-NNN.json test files |
| 3. Plan | Tests are grouped into logical sections in plans/e2e-plan.json |
| 4. Run | Execute individual tests or the full suite with one click |
| 5. Autoheal | Failing tests are analyzed, root-caused, and regenerated automatically |
Get started in 5 minutes
- Download AutoReg for your OS from autoreg-ai.vercel.app/download and install it
- Launch AutoReg
- Install the AutoReg: Skill Installer extension in VS Code — it adds the
generate-autoregskill to your coding agent, which writes yourautoreg.mdspec automatically from your app’s source code
Then in the app:
- New Workflow (
Ctrl+N) — enter a name, your app’s URL, and paste yourautoreg.mdspec - Watch the agent generate the suite live in the right sidebar
- Click the run icon next to any test to execute it
Full walkthrough: Installation → What is autoreg.md → Generating tests.
Core features
- Browser-grounded generation — uses real ARIA selectors from live DOM, not guessed selectors
- Source-grounded specs — the
generate-autoregskill writesautoreg.mdfrom your codebase with confirmed selectors, verified automatically when imported - Live progress — accordion panel updates as each test is generated
- JSON Step DSL — portable interchange format; readable and editable
- Autoheal loop —
analyze_test_runs→regenerate_failed_test→apply_scenario_fix - Model switching — change the AI model in the chat composer without restart
Quick navigation
- Installation — download, install, first launch
- What is autoreg.md — what the spec is and what it contains
- Generating autoreg.md — auto-generate the spec from source code
- Generating tests — create a workflow and run the 3-step agent
- Running and managing tests — execute, review, edit scenarios
- Autohealing — analyze failures and regenerate broken tests
- Quick Reference — commands, prompts, and DSL cheat sheet