gh-project-list(1)

gh-project-list1

List the projects for an owner

Usage

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 status

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.

Examples

# List the current user's projects
$ gh project list
# List the projects for org github including closed projects
$ gh project list --owner github --closed

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.