Qualflare CLI Tool - Upload & Query Test Results
Upload test results from 23 frameworks with the Qualflare CLI. Query suites, cases, plans, launches, and defects — supports JUnit, pytest, Jest, and more.
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 23 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
# Install (see Installation for details)
brew install qualflare/tap/qf
# Save your API token under a local identifier
qf login myapp qf_your_token_here
# Upload test results
qf myapp collect results.xml
# List test suites
qf myapp suites listCommands
Authentication
| Command | Description |
|---|---|
login <identifier> <token> | Save an API token under a local project identifier |
logout <identifier> | Remove saved credentials for an identifier |
projects | List all saved project identifiers |
Data Collection
| Command | Description |
|---|---|
collect | Parse and upload test results to Qualflare |
validate | Validate test result files without uploading |
list-formats | List all supported test frameworks |
version | Display CLI version information |
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.
| Command | Description |
|---|---|
suites list / suite get | List and inspect test suites |
cases list / case get | List and inspect test cases |
plans list / plan get | List and inspect test plans |
launches list / launch get | List and inspect test launches |
defects list / defect get | List and inspect defects |
clusters list / cluster get | List and inspect failure clusters |
milestones list / milestone get | List and inspect milestones |
Next Steps
- Install the CLI for your platform
- Configure authentication and save your first identifier
- Learn about the collect command
- Explore other commands
- Set up CI/CD integration
Related Sections
- Core Concepts — what suites, cases, launches, and defects are
- Feature Reference — full UI reference for the resources these commands query
- Integrations — connect CI/CD results to GitHub, Slack, and Jira
- FAQ — quick answers about the CLI tool
Webhooks
Configure Qualflare project webhooks to receive HTTP callbacks when events occur, such as test results being collected or defects being created.
Install Qualflare CLI - macOS, Linux, Windows
Install the Qualflare CLI (qf) on macOS, Linux, or Windows. Step-by-step guide for Homebrew and binary download installation methods.