Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GH-ISSUE-LIST(1)	       GitHub CLI manual	      GH-ISSUE-LIST(1)

NAME
       gh-issue-list - List issues in a	repository

SYNOPSIS
       gh issue	list [flags]

DESCRIPTION
       List  issues  in	 a GitHub repository. By default, this only lists open
       issues.

       The search query	syntax is documented here:

       <https://docs.github.com/en/search-github/searching-on-github/search-
       ing-issues-and-pull-requests>

       On supported GitHub hosts, advanced issue search	syntax can be used  in
       the  --search  query. For more information about	advanced issue search,
       see:

       <https://docs.github.com/en/issues/tracking-your-work-with-issues/us-
       ing-issues/filtering-and-searching-issues-and-pull-requests#build-
       ing-advanced-filters-for-issues>

OPTIONS
       --app <string>
	      Filter by	GitHub App author

       -a, --assignee <string>
	      Filter by	assignee

       -A, --author <string>
	      Filter by	author

       -q, --jq	<expression>
	      Filter JSON output using a jq expression

       --json <fields>
	      Output JSON with the specified fields

       -l, --label <strings>
	      Filter by	label

       -L, --limit <int> (default 30)
	      Maximum number of	issues to fetch

       --mention <string>
	      Filter by	mention

       -m, --milestone <string>
	      Filter by	milestone number or title

       -S, --search <query>
	      Search issues with query

       -s, --state <string> (default "open")
	      Filter by	state: {open|closed|all}

       -t, --template <string>
	      Format JSON output using a Go template; see "gh help formatting"

       -w, --web
	      List issues in the web browser

OPTIONS	INHERITED FROM PARENT COMMANDS
       -R, --repo <[HOST/]OWNER/REPO>
	      Select another repository	using the [HOST/]OWNER/REPO format

ALIASES
       gh issue	ls

JSON FIELDS
       assignees, author, body,	closed,	 closedAt,  closedByPullRequestsRefer-
       ences,  comments,  createdAt,  id, isPinned, labels, milestone, number,
       projectCards, projectItems, reactionGroups, state, stateReason,	title,
       updatedAt, url

EXIT CODES
       0: Successful execution

       1: Error

       2: Command canceled

       4: Authentication required

       NOTE:  Specific	commands  may have additional exit codes. Refer	to the
       command's help for more information.

EXAMPLE
       $ gh issue list --label "bug" --label "help wanted"
       $ gh issue list --author	monalisa
       $ gh issue list --assignee "@me"
       $ gh issue list --milestone "The	big 1.0"
       $ gh issue list --search	"error no:assignee sort:created-asc"
       $ gh issue list --state all

SEE ALSO
       gh-issue(1)

				   Nov 2025		      GH-ISSUE-LIST(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-issue-list&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help