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

NAME
     gh-project-list - List the projects for an owner

SYNOPSIS
     gh project list [flags]

OPTIONS
     --closed
	    Include closed projects

     --format <string>
	    Output format: {json}

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

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

     --owner <string>
	    Login of the owner

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

     -w, --web
	    Open projects list in the browser

ALIASES
     gh project ls

EXIT CODES
     0: Successful execution

     1: Error

     2: Command canceled

     4: Authentication required

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

EXAMPLE
     # List the current user's projects
     $ gh project list

     # List the projects for org github including closed projects
     $ gh project list --owner github --closed

SEE ALSO
     gh-project(1)

				    Aug 2026		      GH-PROJECT-LIST(1)

home | help