gh-project-list(1)

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 command'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)

Jul 2025 GitHub CLI v2.76.2