.nh
.TH "GH-GIST-LIST" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-gist-list \- فهرست کردن گیست‌های شما


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh gist list [flags]\fR


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

.PP
می‌توانید با استفاده از
.B \-\-filter
از یک عبارت باقاعده برای فیلتر کردن توضیحات، نام پرونده‌ها یا حتی محتوای پرونده‌های درون گیست استفاده کنید.

.PP
برای مشاهده ساختار عبارات باقاعده پشتیبانی‌شده، به
\[la]https://pkg.go.dev/regexp/syntax\[ra]
مراجعه نمایید.

.PP
از
.B \-\-include-content
برای گنجاندن محتوای پرونده‌ها استفاده کنید؛ توجه داشته باشید که این کار کندتر خواهد بود و محدودیت نرخ درخواست (rate limit) بیشتری را مصرف می‌کند. به‌جای چاپ یک جدول، کد با برجسته‌سازی‌هایی مشابه
.B gh search code
چاپ خواهد شد:

.EX
{{gist ID}} {{file name}}
    {{description}}
        {{matching lines from content}}
.EE

.PP
هنگامی که خروجی به جای دیگری تغییر مسیر داده شود، هیچ برجسته‌سازی یا رنگ دیگری چاپ نمی‌شود.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--filter\fR \fB<expression>\fR
فیلتر کردن گیست‌ها با استفاده از یک عبارت باقاعده

.TP
\fB--include-content\fR
گنجاندن محتوای پرونده‌های گیست هنگام فیلتر کردن

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 10)\fR
حداکثر تعداد گیست‌ها برای واکشی

.TP
\fB--public\fR
نمایش فقط گیست‌های عمومی

.TP
\fB--secret\fR
نمایش فقط گیست‌های محرمانه


.SH "نام‌های مستعار (ALIASES)"
gh gist ls


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن تمام گیست‌های محرمانه از حساب کاربری شما
$ gh gist list --secret

# یافتن تمام گیست‌هایی از حساب کاربری شما که در هر کجای آن‌ها به "octo" اشاره شده است
$ gh gist list --filter octo --include-content

.EE


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