This repository provides the QA Wolf Command Line Interface (CLI), enabling users to execute QA Wolf test flows directly from their terminal, CI pipelines, or via AI agents. It serves developers and QA engineers looking to integrate automated testing into their workflows, offering a local execution environment that synchronizes with the broader QA Wolf platform for enhanced test creation, management, and cloud-based execution.

How It Works

The QA Wolf CLI manages and runs test flows locally, leveraging a cache for flow definitions and automatically installing necessary runtime dependencies. It acts as a bridge to the full QA Wolf platform, allowing for seamless execution of tests defined elsewhere. The CLI also supports local-only project initialization and integrates with AI agents through a dedicated Claude Code agent skill, auto-generated from its command tree.

Quick Start & Requirements

Installation can be done globally via npm, pnpm, yarn, or bun (npm install -g @qawolf/cli). Alternatively, standalone precompiled binaries are available for Linux, macOS, and Windows on GitHub Releases, eliminating the need for Node.js. To use the CLI with the QA Wolf platform, a QA Wolf account is required (sign up at qawolf.com), and authentication is handled via qawolf auth login or by setting the QAWOLF_API_KEY environment variable. Supported Node.js versions are active LTS and newer (currently Node 22+).

• Primary Install: npm install -g @qawolf/cli or download standalone binaries.
• Prerequisites: QA Wolf account, Node.js (for npm install method).
• Docs: docs.qawolf.com
• Get Started: qawolf.com

Highlighted Details

• Supports execution from terminal, CI, and AI agents.
• Standalone binaries available, requiring no Node.js installation.
• Integrates with the full QA Wolf platform for AI-powered test generation, managed cloud execution, and team collaboration.
• Features a Claude Code agent skill for AI integration.
• Manages local flow caching and runtime dependency installation.

Maintenance & Community

Development setup instructions are available in CONTRIBUTING.md. Bug reports and feature requests should be filed as GitHub issues. Specific community channels (e.g., Discord, Slack) or a public roadmap are not detailed in the README.

Licensing & Compatibility

The project is licensed under the Apache-2.0 license. This license is generally permissive and compatible with commercial use and closed-source linking.

Limitations & Caveats

The README mentions a "Known issues" section detailing current limitations and workarounds, but these are not specified in the provided text. The CLI's full capabilities, particularly AI-powered features and managed cloud execution, are dependent on the broader QA Wolf platform.