从终端或配置单元运行QA Wolf流程。

CLI在本地运行和管理流程。流程创建、AI驱动的测试生成、托管云执行和团队协作是完整QA Wolf平台的一部分。完整文档请参见 docs.qawolf.com，或 qawolf.com 入门。

安装

试试不安装：

支持的节点版本：Node 24.14.1+。

独立二进制

每个 GitHub 版本都附带预编译二进制文件——无需Node.js：qawolf-linux-x64、qawolf-linux-arm64、qawolf-darwin-x64、qawolf-darwin-arm64 和 qawolf-windows-x64.exe。

快速开始

你需要一个QA Wolf账户——请在 qawolf.com 注册。 来自QA Wolf仪表盘的设置→环境。

qawolf flows run --env 从 本地 .qawolf/ 缓存（磁盘上的每个环境副本）运行团队的流程，只有当缓存尚未本地缓存时才优先拉取，并安装所需的运行时依赖。要刷新本地缓存，运行 qawolf flows pull --env ;要本地创建无平台的流程，先运行 qawolf init。

示例

examples/ 目录包含你可以直接运行的示例流程：

QA Wolf CLI

Run QA Wolf flows from your terminal or in CI.

The CLI runs and manages flows locally. Flow creation, AI-powered test generation, managed cloud execution, and team collaboration are part of the full QA Wolf platform. See docs.qawolf.com for the full docs, or qawolf.com to get started.

Install

npm install -g @qawolf/cli
# or: pnpm add -g @qawolf/cli
# or: yarn global add @qawolf/cli
# or: bun add -g @qawolf/cli

Try it without installing:

npx @qawolf/cli --help

Supported Node versions: Node 24.14.1+.

Standalone binaries

Precompiled binaries are attached to each GitHub Release — no Node.js required: qawolf-linux-x64, qawolf-linux-arm64, qawolf-darwin-x64, qawolf-darwin-arm64, and qawolf-windows-x64.exe.

curl -fsSL -o qawolf https://github.com/qawolf/cli/releases/latest/download/qawolf-darwin-arm64
chmod +x qawolf && ./qawolf --help

Quick start

You need a QA Wolf account — sign up at qawolf.com. The `` comes from the QA Wolf dashboard under Settings → Environments.

qawolf auth login                  # or set QAWOLF_API_KEY for CI
qawolf flows run --env 

qawolf flows run --env runs your team’s flows from the local .qawolf/ cache (a per-environment copy of your flows on disk), pulling them first only if they are not already cached locally and installing the runtime dependencies they need. To refresh the local cache, run qawolf flows pull --env ; to author flows locally without the platform, run qawolf init first.

Examples

The examples/ directory contains sample flows you can run directly:

qawolf install   # one-time: install the browser runtime
qawolf flows run examples/example.flow.ts

Commands