QA Kit CLI — AI-assisted QA automation toolkit for Playwright, Cypress, Jest, and more.
Project description
QA Kit
AI-assisted QA automation toolkit for Playwright, Cypress, Jest, Vitest, Selenium, GitHub Actions, and Jenkins.
QA Kit is a CLI toolkit purpose-built for QA automation engineers. It gives your AI coding assistant (Claude Code, GitHub Copilot, Gemini CLI, Cursor, Windsurf, and 25+ more) a complete set of slash commands for the full QA lifecycle — from strategy through CI/CD.
Think of it as Spec Kit for QA: same architecture, same install method, but every command is tailored to testing workflows rather than feature specification.
Install
uv tool install qa-kit-cli
Or with pipx:
pipx install qa-kit-cli
Or with pip:
pip install qa-kit-cli
Quick Start
# Initialize QA Kit in your project (picks up your AI agent automatically)
qakit init
# In your AI agent, run the first command
/qakit.policy
/qakit.strategy
/qakit.testplan
/qakit.write.playwright
/qakit.ci.github-actions
Slash Commands
QA Kit installs 26 slash commands into your AI agent's command directory.
QA Strategy & Planning
| Command | Description |
|---|---|
/qakit.policy |
Create or update the project's test policy (governance, coverage thresholds, frameworks) |
/qakit.strategy |
Generate a QA strategy for a feature — risk areas, priorities, toolchain |
/qakit.testplan |
Produce a structured test plan: scope, entry/exit criteria, environments |
/qakit.coverage |
Analyze existing tests and report gaps against requirements |
/qakit.gaps |
Cross-reference requirements with the test plan and flag untested scenarios |
/qakit.clarify |
Resolve ambiguities in a QA strategy or test plan |
/qakit.pyramid |
Analyze test pyramid balance and recommend adjustments |
Test Writing
| Command | Description |
|---|---|
/qakit.write.playwright |
Write Playwright TypeScript tests with best-practice conventions |
/qakit.write.cypress |
Write Cypress TypeScript e2e/component tests |
/qakit.write.selenium |
Write Selenium WebDriver tests (Python or Java) |
/qakit.write.jest |
Write Jest unit/integration tests |
/qakit.write.vitest |
Write Vitest unit tests for Vite-based projects |
/qakit.write.pom |
Generate Page Object Model classes |
/qakit.write.fixtures |
Generate test fixtures, factories, and seed data |
/qakit.write.a11y |
Write automated accessibility tests (axe-core / Playwright) |
/qakit.write.visual |
Set up visual regression tests (Playwright screenshots / Percy) |
/qakit.write.api |
Write API contract tests (REST/GraphQL) |
CI/CD Pipeline
| Command | Description |
|---|---|
/qakit.ci.github-actions |
Generate GitHub Actions workflow with matrix strategy |
/qakit.ci.jenkins |
Generate a declarative Jenkinsfile for test execution |
/qakit.ci.matrix |
Design cross-browser/platform test matrix |
/qakit.ci.badges |
Add test coverage and quality badges to README |
/qakit.ci.report |
Configure Allure / JUnit XML / HTML reporting in CI |
Test Maintenance
| Command | Description |
|---|---|
/qakit.maintain.flaky |
Diagnose and fix flaky tests |
/qakit.maintain.refactor |
Refactor tests to current framework conventions |
/qakit.maintain.data |
Audit and clean up test data and fixtures |
/qakit.maintain.upgrade |
Upgrade tests to a new framework version |
QA Review
| Command | Description |
|---|---|
/qakit.review.pr |
Review a PR from a QA perspective |
/qakit.review.bugreport |
Generate a structured, Jira-ready bug report |
/qakit.review.accessibility |
Audit a page/component for WCAG 2.1 AA compliance |
Presets
Presets tailor commands to your framework stack. Three are bundled:
qakit preset add playwright # TypeScript + Playwright conventions
qakit preset add cypress # Cypress Component Testing + E2E
qakit preset add lean-qa # Minimal workflow for small teams
Extensions
Extensions add integrations with external tools:
qakit extension add allure # Allure report generation
qakit extension add testrail # TestRail sync
qakit extension add jira # Jira defect tracking
qakit extension add browserstack # Cross-browser cloud testing
Supported AI Agents
QA Kit works with 31 AI coding agents including:
Claude Code · GitHub Copilot · Gemini CLI · Cursor · Windsurf · Amp · OpenCode · Forge · Roo · Kiro CLI · Junie · Devin · Tabnine · and more.
CLI Reference
qakit init Scaffold .qakit/ and install commands
qakit check Verify prerequisites (node, playwright, jest)
qakit version Show version info
qakit integration add <agent> Install an AI agent integration
qakit integration switch <agent> Change the active agent
qakit integration list List installed integrations
qakit preset add <id> Install a preset
qakit preset list List installed presets
qakit preset priority <id> <n> Set preset priority
qakit extension add <id> Install an extension
qakit extension list List installed extensions
qakit workflow run <id> Run a named QA workflow
License
MIT — see LICENSE.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qa_kit_cli-0.1.2.tar.gz.
File metadata
- Download URL: qa_kit_cli-0.1.2.tar.gz
- Upload date:
- Size: 183.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3dbe25533c4eed285cb5564611b79ca163248417dff8d7b24f5f5acc15027036
|
|
| MD5 |
22e10c75810e56420b2a0687715e7809
|
|
| BLAKE2b-256 |
e5a42254137a13a777124582c3d8d45ca8c1f8afa543f5644edc2f824949bb89
|
Provenance
The following attestation bundles were made for qa_kit_cli-0.1.2.tar.gz:
Publisher:
release.yml on qa-kit-cli/qa-kit
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qa_kit_cli-0.1.2.tar.gz -
Subject digest:
3dbe25533c4eed285cb5564611b79ca163248417dff8d7b24f5f5acc15027036 - Sigstore transparency entry: 1670271730
- Sigstore integration time:
-
Permalink:
qa-kit-cli/qa-kit@0ef32860e2c7176379b8066ccc993e21dfba3e8d -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/qa-kit-cli
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0ef32860e2c7176379b8066ccc993e21dfba3e8d -
Trigger Event:
push
-
Statement type:
File details
Details for the file qa_kit_cli-0.1.2-py3-none-any.whl.
File metadata
- Download URL: qa_kit_cli-0.1.2-py3-none-any.whl
- Upload date:
- Size: 145.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d25a489a47322997930e9ac8e7e493b7473e48096ac84bc899ce699a2672e3b
|
|
| MD5 |
83fee6a09eb23ceda2a97fe0f72f81eb
|
|
| BLAKE2b-256 |
50ca44280bf61b9ae447045981d22d09cce2cc5f9586bd580a1ad4cc96aa7cae
|
Provenance
The following attestation bundles were made for qa_kit_cli-0.1.2-py3-none-any.whl:
Publisher:
release.yml on qa-kit-cli/qa-kit
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qa_kit_cli-0.1.2-py3-none-any.whl -
Subject digest:
2d25a489a47322997930e9ac8e7e493b7473e48096ac84bc899ce699a2672e3b - Sigstore transparency entry: 1670271823
- Sigstore integration time:
-
Permalink:
qa-kit-cli/qa-kit@0ef32860e2c7176379b8066ccc993e21dfba3e8d -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/qa-kit-cli
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0ef32860e2c7176379b8066ccc993e21dfba3e8d -
Trigger Event:
push
-
Statement type: