qa-use

@desplega.ai/qa-use

qa-use

AI-powered browser automation and E2E testing

Automate browsers with 37 CLI commands. Define and run E2E tests with YAML. Works with Claude, Cursor, and any MCP client.

Get StartedGet API KeyGitHubnpm

# Features

## Browser Automation

37 CLI Commands

Navigate, click, fill, type, hover, drag, screenshot, and more. Full Playwright power from the terminal.

REPL Mode

Interactive browser sessions for exploration and debugging. Auto-snapshot diffs after every action.

Dual Targeting

Target elements by accessibility refs (fast) or natural language descriptions (AI-powered semantic selection).

## E2E Testing

YAML Test Definitions

Human-readable, version-controllable. 40+ actions, AI assertions, variable interpolation.

Cloud Execution

Sync tests to desplega.ai. Run in CI/CD with GitHub Actions. Persistent storage and reporting.

Self-Healing

AI auto-fixes broken selectors with --autofix. Tests adapt as your UI evolves. No more flaky tests.

# Getting Started

Install, automate a browser, or write your first test. Works with any web application.

Install and configure

# Install globally$ npm install -g @desplega.ai/qa-use # Configure your API key (get one at app.desplega.ai)$ qa-use setup

Automate a browser

37 commands for interactive browser control.

# Start a browser session (visible)$ qa-use browser create --no-headless # Navigate to your app$ qa-use browser goto https://myapp.com # See what's on the page (ARIA snapshot)$ qa-use browser snapshot # Interact with elements$ qa-use browser click "Sign In"$ qa-use browser fill e12 "user@example.com"$ qa-use browser screenshot /tmp/shot.png # Done$ qa-use browser close

Write a test

YAML definitions with variables and AI assertions.

qa-tests/login.yaml
name: Login Testvariables:   base_url: http://localhost:3000  email: test@example.com  password: secret123steps:   - action: goto    url: $base_url/login  - action: fill    target: email input    value: $email  - action: fill    target: password input    value: $password  - action: click    target: sign in button  - action: to_be_visible    target: dashboard

Run it

# Run against your local app (tunnel mode)$ qa-use test run login --tunnel   ✓ Login Test passed (3.2s)

Add to Claude

Plugin, MCP server, or skill for Claude Code.

# Add from the marketplace$ claude plugin marketplace add desplega-ai/qa-use # Then install the plugin$ claude plugin install qa-use@desplega.ai # Add as MCP server$ claude mcp add desplega-qa -- npx @desplega.ai/qa-use mcp

Add to any other AI assistant

Works with VS Code Copilot, Cursor, Gemini CLI, and any MCP client.

# Run the MCP server$ npx @desplega.ai/qa-use mcp # Install the skill$ npx skills add https://github.com/desplega-ai/qa-use --skill qa-use