Text of cli.github.com › manual › gh_repo_read-dir as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

GitHub CLI | Take GitHub to the command line

CLI manual gh repo read-dir gh repo read-dir [<path>] [flags] List the contents of a directory in a GitHub repository without cloning it. This command is in preview and subject to change without notice. By default, the directory is listed from the default branch. Use the --ref flag to list from a specific branch, tag, or commit. When no path is given, the repository root is listed. Options -q , --jq <expression> Filter JSON output using a jq expression --json <fields> Output JSON with the specified fields --ref <string> The branch, tag, or commit to list from -R , --repo <[HOST/]OWNER/REPO> Select another repository using the [HOST/]OWNER/REPO format -t , --template <string> Format JSON output using a Go template; see "gh help formatting" JSON Fields gitSHA , gitType , mode , modeOctal , name , nameRaw , path , pathRaw , size , submodule , type Examples # List the root of the default branch $ gh repo read-dir --repo cli/cli # List a subdirectory $ gh repo read-dir docs --repo cli/cli # List a directory at a specific ref $ gh repo read-dir docs --repo cli/cli --ref v2.50.0 # Print selected fields as JSON $ gh repo read-dir docs --repo cli/cli --json name,path,type,size See also gh repo