Skip to main content

​
qatech CLI

qatech is the official command-line tool for QA.tech. It lets you run end-to-end tests, inspect results, expose local servers via tunnels, and chat with the QA.tech agent - all from the terminal. The CLI is designed to be agent-friendly: every command supports --json output, --help with copy-pasteable examples, and exits non-zero on failure so AI coding agents can drive it reliably from your terminal.

​
Install

Requires Node.js 18+.

​
Quick start

1

Get an API key

Sign in at app.qa.tech → Settings → Integrations → API.
2

Configure the CLI

The key is saved to .qatech/config.json in the current directory by default.
3

Discover your tests

4

Run a test

Streams progress to your terminal and exits with code 1 if any test fails.

​
Commands

Run qatech <command> --help for detailed flags on any command.

​
Configuration resolution

The CLI resolves credentials in this order - first match wins:
  1. --api-key flag (per-command override)
  2. QATECH_API_KEY environment variable
  3. .qatech/config.json in the current directory (project-local)
  4. ~/.qatech/config.json (global fallback)

​
Output conventions

  • stdout → data (JSON or human-readable results)
  • stderr → progress messages, errors, hints
  • With --json, stdout is always valid JSON - safe to pipe to jq
  • Errors with --json are also JSON: { "error": true, "message": "...", "statusCode": 401 }
This split lets you pipe results into jq cleanly:

​
See also