GH-REPO-READ-DIR(1)            GitHub CLI manual           GH-REPO-READ-DIR(1)



<?><?><?> (NAME)
       gh-repo-read-dir - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       (<?><?><?><?><?><?><?><?><?>)



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh repo read-dir [<path>] [flags]



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


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


       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?><?> --ref <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       -q, --jq <expression>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> jq


       --json <fields>
              <?><?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>


       --ref <string>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>


       -R, --repo <[HOST/]OWNER/REPO>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> [HOST/]OWNER/REPO


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



<?><?><?><?><?><?><?> JSON (JSON FIELDS)
       gitSHA, gitType, mode, modeOctal, name, nameRaw, path, pathRaw, size,
       submodule, type



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


       1: <?><?><?>


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


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


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



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       $ gh repo read-dir --repo cli/cli

       # <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       $ gh repo read-dir docs --repo cli/cli

       # <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> (ref) <?><?><?>
       $ gh repo read-dir docs --repo cli/cli --ref v2.50.0

       # <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> JSON
       $ gh repo read-dir docs --repo cli/cli --json name,path,type,size




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

                                   Sep 2026                GH-REPO-READ-DIR(1)