qa-use

qa-use

QA automation CLI for browser testing and E2E test management.

Quick Start

# Install globally
npm install -g @desplega.ai/qa-use

# Or use with npx
npx @desplega.ai/qa-use setup

Getting Started

1. Setup

qa-use setup                    # Configure your API key
qa-use test init                # Initialize test directory with example

2. Create Your First Test

Create qa-tests/login.yaml:

name: Login Test
app_config: your-app-config-id
steps:
  - action: goto
    url: /login
  - action: fill
    target: email input
    value: [email protected]
  - action: click
    target: login button
  - action: to_be_visible
    target: dashboard

3. Run Tests

qa-use test run login           # Run single test
qa-use test run --all           # Run all tests

CLI Reference

Test Commands

Command	Description
qa-use test init	Initialize test directory with example
qa-use test run <name>	Run a test by name
qa-use test run --all	Run all tests in qa-tests/
qa-use test list	List local tests
qa-use test list --cloud	List cloud tests
qa-use test validate <name>	Validate test syntax
qa-use test sync --push	Push local tests to cloud
qa-use test sync --pull	Pull cloud tests to local
qa-use test export <id>	Export cloud test to local file

Run qa-use test --help for all options.

Browser Commands

Interactive browser control for test development and debugging:

qa-use browser create                  # Start browser session
qa-use browser goto https://example.com
qa-use browser snapshot                # Get element refs like [ref=e3]
qa-use browser click e3                # Click by element ref
qa-use browser fill e5 "hello"         # Fill input field
qa-use browser run                     # Interactive REPL mode

Command	Description
qa-use browser create	Start browser session
qa-use browser goto <url>	Navigate to URL
qa-use browser snapshot	Get page element refs
qa-use browser click <ref>	Click element by ref
qa-use browser fill <ref> <value>	Fill input field
qa-use browser screenshot <path>	Save screenshot
qa-use browser run	Interactive REPL mode
qa-use browser close	Close browser session

Run qa-use browser --help for the full list of 29 browser commands.

API Commands

Dynamic API access powered by live OpenAPI (/api/v1/openapi.json) with local cache fallback.

qa-use api ls                             # List endpoints from live/cached OpenAPI
qa-use api /api/v1/tests                  # Call endpoint (method inferred)
qa-use api -X POST /api/v1/tests-actions/run --input body.json
qa-use api ls --refresh                   # Force refresh OpenAPI cache
qa-use api ls --offline                   # Use cached OpenAPI only

Command	Description
qa-use api ls	List /api/v1/* endpoints from OpenAPI
qa-use api <path>	Send API request to endpoint
qa-use api ... --refresh	Force OpenAPI spec refresh
qa-use api ... --offline	Use cached spec without network

If live spec fetch fails, qa-use falls back to the last cached spec and prints a stale-cache warning.

Setup Commands

Command	Description
qa-use setup	Interactive configuration (API key, base URL, etc.)
qa-use info	Show current configuration
qa-use install-deps	Install Playwright browsers

Test Definition Format

Tests are YAML files with steps that describe user interactions:

name: Checkout Flow
app_config: your-app-id
variables:
  email: [email protected]
depends_on: login-test          # Optional dependency
steps:
  - action: goto
    url: /cart
  - action: click
    target: checkout button
  - action: fill
    target: email input
    value: $email
  - action: to_be_visible
    target: order confirmation

Supported actions:

Category	Actions
Navigation	goto, go_back, go_forward, reload
Input	fill, type, click, hover, press, check, uncheck, select_option
Waiting	wait_for_selector, wait_for_timeout, wait_for_load_state
Assertions	to_be_visible, to_have_text, to_have_url, to_contain_text, to_be_checked
Advanced	ai_action, ai_assertion, extract_structured_data

See SETUP.md for the complete test definition guide.

Configuration

Environment Variables