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 myapp launches list ​

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

Syntax ​

bash
qf myapp 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

Examples ​

bash
# List all launches
qf myapp launches list

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

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

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

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

# Paginate through results
qf myapp 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 myapp launch get ​

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

Syntax ​

bash
qf myapp launch get <seq>

Arguments ​

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

Examples ​

bash
# Get details for launch #88
qf myapp 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 myapp launches list --sort-by createdAt --sort-desc | jq '.launches[0]'

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

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

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

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

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

See Also ​