Suites Commands
List and inspect test suites with the Qualflare CLI. Query suites by name, sort and paginate results, and retrieve suite details.
Suites Commands
Test suites in Qualflare are collections of related test cases, used to organize your testing work by feature, module, or team. The suites commands let you list and inspect suites from the command line.
qf myapp suites list
List test suites in your project. Results are output as pretty-printed JSON to stdout.
Syntax
qf myapp suites list [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--query | string | "" | Filter suites by name or description |
--page | int | 0 | Page number for paginated results |
--sort-by | string | "" | Field to sort results by (e.g., name, createdAt) |
--sort-desc | bool | false | Sort in descending order |
Examples
# List all suites
qf myapp suites list
# Search for suites by name
qf myapp suites list --query "authentication"
# Sort by name, alphabetically
qf myapp suites list --sort-by name
# Sort by creation date, newest first
qf myapp suites list --sort-by createdAt --sort-desc
# Paginate through large result sets
qf myapp suites list --page 2Example Output
{
"suites": [
{
"seq": 42,
"title": "Authentication Tests",
"description": "Tests for login, logout, and session management",
"caseCount": 18,
"createdAt": "2026-03-15T10:30:00Z"
},
{
"seq": 43,
"title": "Checkout Flow",
"description": "End-to-end checkout and payment tests",
"caseCount": 11,
"createdAt": "2026-03-16T08:00:00Z"
}
]
}qf myapp suite get
Retrieve full details for a single test suite by its sequence number.
Syntax
qf myapp suite get <seq>Arguments
| Argument | Description |
|---|---|
seq | The suite's sequence number (visible in the Qualflare UI and suites list output) |
Examples
# Get details for suite #42
qf myapp suite get 42Example Output
{
"seq": 42,
"title": "Authentication Tests",
"description": "Tests for login, logout, and session management",
"caseCount": 18,
"createdAt": "2026-03-15T10:30:00Z",
"updatedAt": "2026-03-20T14:15:00Z"
}Working with JSON Output
All suites commands output pretty-printed JSON, making them easy to pipe into jq for filtering and transformation.
# Extract just suite titles and sequence numbers
qf myapp suites list | jq '.suites[] | {seq, title}'
# Count total suites returned
qf myapp suites list | jq '.suites | length'
# Filter suites with more than 10 cases
qf myapp suites list | jq '[.suites[] | select(.caseCount > 10)]'
# Extract all suite IDs as a plain list
qf myapp suites list | jq '[.suites[].seq]'
# Find suites matching a pattern in the title
qf myapp suites list | jq '[.suites[] | select(.title | test("auth"; "i"))]'
# Get the name of suite #42
qf myapp suite get 42 | jq '.title'See Also
- Cases Commands — List and inspect test cases within a suite
- Plans Commands — Organize suites into structured test plans
- Collect Command — Upload test results to Qualflare
- Configuration — Environment variables and global flags reference
CI/CD Integration - Jenkins, GitHub Actions, GitLab
Integrate Qualflare CLI into Jenkins, GitHub Actions, GitLab CI, CircleCI, and more. Token setup, auto-detection, and platform-specific examples.
Cases Commands
List, inspect, and retrieve steps for test cases with the Qualflare CLI. Filter by state, priority, and suite. Query case details and step-by-step instructions.