.nh
.TH "GH-REPO-READ-DIR" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-repo-read-dir \- فهرست کردن محتویات یک دایرکتوری در یک مخزن (پیش‌نمایش)


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh repo read-dir [<path>] [flags]\fR


.SH "توضیحات (DESCRIPTION)"
محتویات یک دایرکتوری را در یک مخزن گیت‌هاب بدون کلون کردن آن فهرست می‌کند.

.PP
این دستور در مرحله پیش‌نمایش قرار دارد و ممکن است بدون اطلاع قبلی تغییر کند.

.PP
به‌طور پیش‌فرض، دایرکتوری از شاخه پیش‌فرض فهرست می‌شود. از گزینه
.B \-\-ref
برای فهرست کردن از یک شاخه، تگ یا کامیت خاص استفاده کنید. هنگامی که هیچ مسیری مشخص نشده باشد، ریشه مخزن فهرست می‌شود.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از عبارت jq

.TP
\fB--json\fR \fB<fields>\fR
تولید خروجی JSON با فیلدهای مشخص‌شده

.TP
\fB--ref\fR \fB<string>\fR
شاخه، تگ یا کامیتی که فهرست‌بندی از آن انجام می‌شود

.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از یک الگوی Go؛ دستور "gh help formatting" را ببینید


.SH "فیلدهای JSON (JSON FIELDS)"
\fBgitSHA\fR, \fBgitType\fR, \fBmode\fR, \fBmodeOctal\fR, \fBname\fR, \fBnameRaw\fR, \fBpath\fR, \fBpathRaw\fR, \fBsize\fR, \fBsubmodule\fR, \fBtype\fR


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن ریشه شاخه پیش‌فرض
$ 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

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-repo(1)\fR