@worldofz/validate.qa

Local test runner for the validate.qa AI testing platform.

This package enables you to execute Playwright tests generated from your voice narrations directly on your local machine, securely connecting to your validate.qa cloud project.

Quick Start

1. Install (Global or NPX)

You don't need to install it globally if you use npx, but it's completely supported:

npm install -g @worldofz/validate.qa

2. Login

Generate a runner token from your validate.qa Project Settings → Local Runner. Your credentials will be saved securely to ~/.validate.qa/credentials.json.

npx @worldofz/validate.qa login --token urt_xxxxxxxxxxxx --server https://your-server.com

3. Start the Runner

Starts the runner daemon, polling for pending test runs from the cloud and executing them locally via Chromium:

npx @worldofz/validate.qa start

Commands

| Command | Description | |---------|-------------| | login | Saves credentials for future test executions | | start | Starts the local runner (uses saved credentials or CLI flags) | | status | Pings the server to verify your runner token and connection | | logout | Clears all saved runner credentials from your machine |

Runner Modes

You can specify different execution strategies when starting the runner:

npx @worldofz/validate.qa start --mode <mode>

• playwright-native (default): Runs generated Playwright scripts reliably using native browser automation.
• mcp-agent: AI-driven resilient execution via MCP (Model Context Protocol). Requires an OPENAI_API_KEY exported in your terminal environment.

Security

urt_ runner tokens are:

• Project-scoped: They cannot access sessions, user accounts, or cross-project data.
• Revocable: Instantly cancel tokens from the dashboard if compromised.
• Client-only: Your local Chrome instances run locally and post test results back.

Generated by validate.qa