GH-PROJECT-ITEM-LIST(1)        GitHub CLI manual       GH-PROJECT-ITEM-LIST(1)



<?><?><?> (NAME)
       gh-project-item-list - <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh project item-list [<number>] [flags]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?>.


       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> API
       (<?><?><?><?> github.com <?> GHES <?><?><?><?> <?>.<?><?> <?><?>
       <?><?><?><?>)<?> <?><?><?><?><?> --query <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:
       <https://docs.github.com/en/issues/planning-and-tracking-with-
       projects/customizing-views-in-your-project/filtering-projects>



<?><?><?><?><?><?><?><?> (OPTIONS)
       --field <stringArray>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>


       --field-id <stringArray>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>


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


       -q, --jq <expression>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> jq


       -L, --limit <int> (default 30)
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?>


       --owner <string>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?>. <?><?> "@me"
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?>


       --query <string>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              Projects<?> <?><?><?><?><?> "assignee:octocat -status:Done"


       -t, --template <string>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> Go<?>
              <?><?><?><?><?> "gh help formatting" <?><?> <?><?><?><?><?><?>



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> "1" <?><?><?><?><?> <?><?><?><?>
       $ gh project item-list 1 --owner "@me"

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       $ gh project item-list 1 --owner "@me" --query "assignee:monalisa"

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       $ gh project item-list 1 --owner "@me" --query "assignee:@me is:issue is:open"

       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> "bug" <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       $ gh project item-list 1 --owner "@me" --query "label:bug -status:Done"

       # <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> "Status" <?> "Priority" <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       $ gh project item-list 1 --owner "@me" --field "Status" --field "Priority"




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-project(1)

                                   Sep 2026            GH-PROJECT-ITEM-LIST(1)