glab(1)

NAME

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

SYNOPSIS

glab milestone list [flags]

DESCRIPTION

Filter by state with --state (active or closed), by title with --title, or by free-text search with --search. For group milestones, use --include-ancestors to also include milestones from ancestor groups.

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

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

OPTIONS

--group="" The ID or URL-encoded path of the group.

--include-ancestors[=false] Include milestones from all parent groups.

--jq="" Filter JSON output with a jq expression.

-F, --output="text" Format output as: text, json.

-p, --page=1 Page number.

-P, --per-page=20 Number of items to list per page.

--project="" The ID or URL-encoded path of the project.

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

--show-id[=false] Show IDs in table output.

--state="" Return only 'active' or 'closed' milestones.

--title="" Return only the milestones having the given title.

OPTIONS INHERITED FROM PARENT COMMANDS

-h, --help[=false] Show help for this command.

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

EXAMPLE

# 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