Overview

Use this section for stable command descriptions, flags, configuration, environment variables, and exit codes.

Commands

qawolf auth — manage authentication.
qawolf flows — run, list, and pull flows.
qawolf install — install runtime dependencies for the project.
qawolf init — scaffold a project in the current directory.
qawolf doctor — diagnose problems running flows locally.
qawolf run — trigger and manage QA Wolf runs on the platform.

Example invocation:

qawolf auth login
qawolf flows pull --env <env_id>
qawolf flows run

Find the environment ID in the app URL — see Pull flows.

Global options

The following flags apply to every command:

--verbose — emits debug logs to stderr.
--json — formats output as JSON.
--agent — formats output for agent consumption.
-V, --version — prints the CLI version.

When the CLI detects a recognized CI environment (CI, GITHUB_ACTIONS, GITLAB_CI, CIRCLECI, JENKINS_URL, BUILDKITE), output defaults to JSON. When it detects a recognized agent environment (CLAUDE_CODE, CURSOR_SESSION_ID), output defaults to agent mode. With --json or --agent, the CLI writes the structured result to stdout and diagnostic text to stderr, so scripts can parse stdout directly.

Exit codes

Every qawolf CLI command exits with one of the codes below.

Code	Name	Meaning
`0`	`success`	The command completed successfully.
`1`	`testFailure`	One or more flows failed.
`2`	`invalidArgs`	A Commander parse error, an unknown subcommand, or a bad flag value.
`3`	`auth`	`QAWOLF_API_KEY` is missing or invalid.
`4`	`network`	The QA Wolf API was unreachable, a download from storage failed, or a registry was unreachable.
`5`	`config`	`qawolf.config.ts` is invalid, or a file collision occurred during `qawolf init`.
`6`	`timeout`	A command exceeded its timeout.
`7`	`payment`	The workspace’s billing state prevented the command.

Flow conventions

@qawolf/flows

@qawolf/pom

@qawolf/testkit

@qawolf/emails

@qawolf/cli

Local execution

@qawolf/ci-sdk

Triggers

REST

Commands

Global options

Exit codes

​Commands

​Global options

​Exit codes

Commands

Global options

Exit codes