Milestones

Milestones in Qualflare represent project milestones or release targets. Test launches can be associated with milestones for organized tracking across sprints and releases.

qf myapp milestones list

List all milestones in the project, with optional search and sorting.

Syntax

qf myapp milestones list [flags]

Flags

Flag	Type	Default	Description
--query	string	—	Search query to filter milestones by name or description
--page	int	0	Page number for paginated results
--sort-by	string	—	Field name to sort results by
--sort-desc	bool	false	Sort results in descending order

Examples

# List all milestones
qf myapp milestones list

# Search for a milestone by name
qf myapp milestones list --query "v2.0"

# Search for release milestones
qf myapp milestones list --query "release"

# Sort by due date, soonest first
qf myapp milestones list --sort-by dueDate

# Sort by due date, furthest out first
qf myapp milestones list --sort-by dueDate --sort-desc

# Paginate through results
qf myapp milestones list --page 2

Example Output

{
  "milestones": [
    {
      "seq": 3,
      "title": "v2.0 Release",
      "description": "Feature-complete release with new payment flow",
      "dueDate": "2026-04-30T00:00:00Z",
      "createdAt": "2026-02-01T10:00:00Z"
    }
  ]
}

---

qf myapp milestone get <seq>

Fetch full details for a single milestone by its sequence number.

Syntax

qf myapp milestone get <seq>

Arguments

Argument	Description
seq	The sequence number of the milestone to retrieve

Examples

# Get milestone with sequence number 3
qf myapp milestone get 3

# Get milestone and check the due date
qf myapp milestone get 3 | jq '.dueDate'

Example Output

{
  "seq": 3,
  "title": "v2.0 Release",
  "description": "Feature-complete release with new payment flow",
  "dueDate": "2026-04-30T00:00:00Z",
  "createdAt": "2026-02-01T10:00:00Z"
}

Working with JSON Output

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

# Find a milestone by exact title
qf myapp milestones list | jq '.milestones[] | select(.title == "v2.0 Release")'

# List all milestone titles and their due dates
qf myapp milestones list | jq '.milestones[] | {title, dueDate}'

# Find milestones due after a specific date
qf myapp milestones list | jq '.milestones[] | select(.dueDate > "2026-04-01T00:00:00Z") | {seq, title, dueDate}'

# Get all milestone sequence numbers
qf myapp milestones list | jq '[.milestones[].seq]'

# Count total milestones
qf myapp milestones list | jq '.milestones | length'

Filtering Launches by Milestone

Once you know a milestone's sequence number, you can filter test launches by it using the launches command:

# List all launches associated with milestone 3
qf myapp launches list --milestone 3

This makes it easy to review all test activity tied to a specific release target.

See Also

• Collect — Upload test results and associate them with a milestone
• Defects — List and inspect defect records linked to failed test cases
• Other Commands — Utility commands including validate and list-formats
• Configuration — Environment variables and global flags reference