Skip to content
The docs are now organized by product area. Old links still work. Report a broken link

Qualflare CLI Tool

Upload test results from 27 frameworks and 4 generic formats with the Qualflare CLI, then query suites, cases, plans, launches and defects.

Last updated

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 27 frameworks and 4 generic formats, 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

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

# Sign in through your browser and save it under a local identifier
qf login myapp

# Upload test results
qf myapp collect results.xml

# List test suites
qf myapp suites list

Commands

Authentication

CommandDescription
login <identifier> [token]Sign in under a local project identifier. In a terminal, qf opens your browser (--no-browser for remote machines). With [token], QF_TOKEN, piped input or --with-token, it saves an access token instead.
logout <identifier>Remove saved credentials for an identifier
projectsList all saved project identifiers

Data Collection

CommandDescription
collectParse and upload test results to Qualflare
validateValidate test result files without uploading
list-formatsList all supported test frameworks
versionPrint the installed qf version

Resource Queries

All resource commands require a saved identifier and output JSON, making them easy to filter with jq. Invoke as qf <identifier> <command>, e.g. qf myapp suites list. See Query project data from the CLI for every flag and output field.

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

  • Core Concepts — what suites, cases, launches, and defects are
  • API & MCP — the REST API and MCP server for the same resources these commands query
  • Integrations — connect CI/CD results to GitHub, Slack, and Jira
  • FAQ — quick answers about the CLI tool