desplega-ai/qa-use

Overview

This skill provides E2E testing and browser automation via the qa-use CLI for Web UI projects. It offers session management, element inspection, interaction commands, test generation, and test execution features tuned for AI-driven development workflows. Use it to run, debug, and maintain automated UI tests against remote or local browsers.

How this skill works

The CLI creates remote or tunneled browser sessions, captures an ARIA-based snapshot to generate stable element refs, and then performs interactions (click, fill, type, upload, etc.) against those refs. It can record sessions to generate YAML tests, run tests with variable overrides or local tunnels, and surface logs, screenshots, and network traces to diagnose failures.

When to use it

• Run end-to-end tests for a web app or verify feature behavior in a browser.
• Automate repetitive UI interactions for demo or data-setup workflows.
• Record a user flow and generate a test YAML from a recorded session.
• Debug failing UI tests using console, network logs, screenshots, and snapshots.
• Test local development servers using the tunnel mode and WebSocket connection.

Best practices

• Always run qa-use browser snapshot before interacting to obtain valid element refs.
• Use --tunnel or WebSocket sessions for localhost testing so cloud runners can access local apps.
• Pass runtime variables with --var to point tests at ephemeral preview URLs or credentials.
• Prefer ref-based interactions; use --text only when semantic matching is required.
• Classify failures (code, test, environment) and use --autofix cautiously to vet AI fixes.

Example use cases

• Create a browser session, navigate to a preview URL, record a login flow, and generate a test YAML.
• Run a nightly test suite with qa-use test run --all and collect screenshots and network logs for failures.
• Debug a flaky selector by taking a snapshot, inspecting ARIA refs, and updating the test step.
• Test an OAuth flow on localhost by creating a tunneled browser session and running qa-use test run with --ws-url.
• Use qa-use browser mfa-totp to generate TOTP codes and fill MFA inputs during auth tests.