Get Started

Launches Commands ​

Launches represent individual test runs in Qualflare, created each time you run qf collect with test results. They record what was tested, when, and against which environment and milestone. The launches commands let you list and inspect launch records from the command line.

qf launches list ​

List test launches in your project. Results are output as pretty-printed JSON to stdout.

Syntax ​

bash
qf launches list [flags]

Flags ​

FlagTypeDefaultDescription
--milestoneint0Filter by milestone sequence number
--environmentstring""Filter by environment UID (e.g., prod, staging)
--pageint0Page number for paginated results
--sort-bystring""Field to sort results by (e.g., createdAt, passRate)
--sort-descboolfalseSort in descending order
--api-keystring""API key for authentication. Overrides QF_API_KEY environment variable.

Examples ​

bash
# List all launches
qf launches list

# Filter launches by milestone
qf launches list --milestone 3

# Filter launches by environment
qf launches list --environment prod

# Combine filters: launches for milestone 3 in staging
qf launches list --milestone 3 --environment staging

# Sort by date, most recent first
qf launches list --sort-by createdAt --sort-desc

# Paginate through results
qf launches list --page 2

Example Output ​

json
{
  "launches": [
    {
      "seq": 88,
      "environment": "prod",
      "milestoneSeq": 3,
      "passed": 104,
      "failed": 2,
      "skipped": 5,
      "total": 111,
      "createdAt": "2026-03-28T14:00:00Z"
    },
    {
      "seq": 87,
      "environment": "staging",
      "milestoneSeq": 3,
      "passed": 99,
      "failed": 7,
      "skipped": 5,
      "total": 111,
      "createdAt": "2026-03-27T11:30:00Z"
    }
  ]
}

qf launch get ​

Retrieve full details for a single launch by its sequence number.

Syntax ​

bash
qf launch get <seq>

Arguments ​

ArgumentDescription
seqThe launch's sequence number (visible in the Qualflare UI and launches list output)

Flags ​

FlagTypeDefaultDescription
--api-keystring""API key for authentication. Overrides QF_API_KEY environment variable.

Examples ​

bash
# Get details for launch #88
qf launch get 88

Example Output ​

json
{
  "seq": 88,
  "environment": "prod",
  "milestoneSeq": 3,
  "branch": "main",
  "commit": "a1b2c3d4e5f6",
  "passed": 104,
  "failed": 2,
  "skipped": 5,
  "error": 0,
  "total": 111,
  "createdAt": "2026-03-28T14:00:00Z"
}

Working with JSON Output ​

All launches commands output pretty-printed JSON, making them easy to pipe into jq for filtering and transformation.

bash
# Find the most recent launch (after sorting by date desc)
qf launches list --sort-by createdAt --sort-desc | jq '.launches[0]'

# Filter launches by environment after fetching
qf launches list | jq '[.launches[] | select(.environment == "prod")]'

# Extract pass rate for each launch (passed / total * 100)
qf launches list | jq '.launches[] | {seq, passRate: (.passed / .total * 100 | round)}'

# Find launches with any failures
qf launches list | jq '[.launches[] | select(.failed > 0)] | .[].seq'

# Summarize stats for a specific launch
qf launch get 88 | jq '{total, passed, failed, skipped, passRate: (.passed / .total * 100 | round)}'

# Count launches per environment
qf launches list | jq 'group_by(.environment) | map({env: .[0].environment, count: length})'

See Also ​