An AI-powered, browser-driven QA specialist for GitHub Copilot Chat in VS Code. Turns plain English into evidence-backed QA reports across desktop, tablet, and mobile — by driving a real browser end to end. No test code. No DSL. No config files.
Heads up: the agent runs on top of GitHub Copilot Chat in Agent Mode, so an active GitHub Copilot subscription (Individual, Business, Enterprise, or Free trial) with Copilot Chat installed and signed in is required.
| Folder | Contents |
|---|---|
| extension/ | The published VS Code extension source (ui-test-agent). |
| web/ | The project landing site — static HTML/CSS/JS, deployable to GitHub Pages, Azure Static Web Apps, Netlify, etc. |
Installing the extension does three things automatically:
- Installs the
UI Testagent (ui-test.agent.md) into your VS Code prompts folder. - Installs 8 named prompt entry points —
/ui-test-smoke,/ui-test-a11y,/ui-test-perf,/ui-test-console,/ui-test-links,/ui-test-responsive,/ui-test-scaffold,/ui-test-run— so any workflow can be launched from Copilot Chat. - Wires up a built-in browser engine so the agent can drive a real browser to perform the checks. Auto-configured — no manual setup, no config files to edit.
No test code, no DSL, no manual configuration.
- Install the extension from the VS Code Marketplace.
- Make sure you're signed in to GitHub Copilot in VS Code.
- Open GitHub Copilot Chat and switch to Agent Mode.
- Try one of these:
@UI Test Test https://example.com on desktop, mobile, tablet
/ui-test-smoke url=https://example.com
/ui-test-a11y url=https://example.com
/ui-test-perf url=https://example.com device=mobile
/ui-test-scaffold
The agent narrates its scope, drives Chrome, and replies with a Markdown report. When you scaffold a project, it writes a committable ./.ui-tests/ folder with starter cases and a reports/ output directory.
| Prompt | What it verifies |
|---|---|
/ui-test-smoke |
Page load, title, no console errors, no 5xx |
/ui-test-console |
Runtime console + network health |
/ui-test-a11y |
Lighthouse accessibility (WCAG / axe) |
/ui-test-perf |
Lighthouse performance + Core Web Vitals |
/ui-test-links |
Same-origin link health / shallow crawl |
/ui-test-responsive |
Overflow + touch-target audit across breakpoints |
/ui-test-scaffold |
Bootstrap a starter .ui-tests/ suite |
/ui-test-run |
Bulk-run a folder of *.ui-test.md cases |
All workflows can fan out across the standard device matrix (desktop · desktopHD · tablet · tabletLand · mobile · mobileSm) with optional network/CPU throttling.
- Active GitHub Copilot subscription (Individual, Business, Enterprise, or Free trial) with Copilot Chat enabled and signed in. The agent runs on top of Copilot Chat in Agent Mode — without an active subscription it cannot run.
- VS Code 1.101+ with the GitHub Copilot Chat extension installed.
- Node.js on
PATH. - Google Chrome / Chromium / Edge installed locally (auto-detected).
cd extension
npm install
npm run compile
# Press F5 in VS Code to launch the Extension Development HostPackage locally:
cd extension
npm run package # produces ui-test-agent-<version>.vsixSee extension/PUBLISHING.md for the full Marketplace publish flow and extension/CHANGELOG.md for release history.
The site in web/ is plain HTML/CSS/JS — no build step, no dependencies.
cd web
# any static server works, e.g.:
npx serve .
# or:
python -m http.server 8080Then open http://localhost:8080 (or whatever port the server prints).
See web/README.md for deployment recipes (GitHub Pages, Azure Static Web Apps, Netlify).
The bundled agent is read-only on application source code. Its editFiles capability is whitelisted to test/report folders only — it can scaffold and write reports, but never modifies the product it tests. Crawls are capped at 25 pages by default. Real credentials and destructive actions are refused unless explicitly authorized.
MIT — see extension/LICENSE.