Skip to content

CLI Tool

The Qualflare CLI (qf) is a command-line tool for interacting with Qualflare from your terminal or CI/CD pipeline. It parses and uploads test results from 20+ frameworks, and provides read access to all your test management data.

Features

  • Auto-detection: Automatically detects test framework from file patterns and content
  • Multi-format support: Parse JUnit, pytest, Go test, Jest, Playwright, Cypress, Newman, k6, and more
  • Resource queries: List and inspect suites, cases, plans, launches, defects, clusters, and milestones
  • CI/CD integration: Environment variables and Git metadata auto-enrichment
  • Validation: Validate test result files before uploading
  • Dry-run mode: Preview parsed results without uploading

Quick Start

bash
# Install (see Installation for details)
brew install qualflare/tap/qf

# Collect test results
qf collect results.xml --project my-app --api-key YOUR_API_KEY

# List test suites
qf suites list --api-key YOUR_API_KEY

Commands

Data Collection

CommandDescription
collectParse and upload test results to Qualflare
validateValidate test result files without uploading
list-formatsList all supported test frameworks
versionDisplay CLI version information

Resource Queries

All resource commands output JSON and can be piped to jq for filtering.

CommandDescription
suites list / suite getList and inspect test suites
cases list / case getList and inspect test cases
plans list / plan getList and inspect test plans
launches list / launch getList and inspect test launches
defects list / defect getList and inspect defects
clusters list / cluster getList and inspect failure clusters
milestones list / milestone getList and inspect milestones

Next Steps