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.
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.
CI, GITHUB_ACTIONS, GITLAB_CI, CIRCLECI, JENKINS_URL, BUILDKITE), output defaults to JSON. When a recognized agent environment is detected (CLAUDE_CODE, CURSOR_SESSION_ID), output defaults to agent mode.
With --json or --agent, the structured result is written 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. |