.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-milestone-list - List milestones in a project or group.


.SH SYNOPSIS
\fBglab milestone list [flags]\fP


.SH DESCRIPTION
Filter by state with \fB--state\fR (\fBactive\fR or \fBclosed\fR), by title with \fB--title\fR,
or by free-text search with \fB--search\fR\&. For group milestones, use
\fB--include-ancestors\fR to also include milestones from ancestor groups.

.PP
By default, milestones are listed for the current project. Use
\fB--project\fR to target a different project, or \fB--group\fR to list
group-level milestones. \fB--project\fR and \fB--group\fR are mutually exclusive.

.PP
Use \fB--output json\fR to format the result as JSON for use with other tools.


.SH OPTIONS
\fB--group\fP=""
	The ID or URL-encoded path of the group.

.PP
\fB--include-ancestors\fP[=false]
	Include milestones from all parent groups.

.PP
\fB--jq\fP=""
	Filter JSON output with a jq expression.

.PP
\fB-F\fP, \fB--output\fP="text"
	Format output as: text, json.

.PP
\fB-p\fP, \fB--page\fP=1
	Page number.

.PP
\fB-P\fP, \fB--per-page\fP=20
	Number of items to list per page.

.PP
\fB--project\fP=""
	The ID or URL-encoded path of the project.

.PP
\fB--search\fP=""
	Return only milestones with a title or description matching the provided string.

.PP
\fB--show-id\fP[=false]
	Show IDs in table output.

.PP
\fB--state\fP=""
	Return only 'active' or 'closed' milestones.

.PP
\fB--title\fP=""
	Return only the milestones having the given title.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.

.PP
\fB-R\fP, \fB--repo\fP=""
	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.


.SH EXAMPLE
.EX
# List milestones in a project
glab milestone list --project 123
glab milestone list --project owner/project

# List milestones in a group
glab milestone list --group example-group

# List only active milestones in a group
glab milestone list --group example-group --state active

# List group milestones, including those from ancestor groups
glab milestone list --group example-group --include-ancestors

# List milestones as JSON
glab milestone list --project owner/project --output json

.EE


.SH SEE ALSO
\fBglab-milestone(1)\fP