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

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


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


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

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

.TP
\fB-k\fR, \fB--key\fR \fB<string>\fR
فیلتر کردن بر اساس پیشوند کلید کش

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

.TP
\fB-O\fR, \fB--order\fR \fB<string> (default "desc")\fR
ترتیب کش‌های بازگردانده‌شده: {asc|desc}

.TP
\fB-r\fR, \fB--ref\fR \fB<string>\fR
فیلتر کردن بر اساس ارجاع (ref)، با قالب
.B refs/heads/
یا
.B refs/pull//merge

.TP
\fB-S\fR, \fB--sort\fR \fB<string> (default "last_accessed_at")\fR
مرتب‌سازی کش‌های واکشی‌شده: {created_at|last_accessed_at|size_in_bytes}

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


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO


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


.SH "فیلدهای JSON (JSON FIELDS)"
\fBcreatedAt\fR, \fBid\fR, \fBkey\fR, \fBlastAccessedAt\fR, \fBref\fR, \fBsizeInBytes\fR, \fBversion\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن کش‌ها برای مخزن فعلی
$ gh cache list

# فهرست کردن کش‌ها برای یک مخزن خاص
$ gh cache list --repo cli/cli

# فهرست کردن کش‌ها مرتب‌شده بر اساس قدیمی‌ترین زمان دسترسی
$ gh cache list --sort last_accessed_at --order asc

# فهرست کردن کش‌هایی که کلید آن‌ها با یک پیشوند مطابقت دارد (یا دقیقاً برابر است)
$ gh cache list --key key-prefix

# فهرست کردن کش‌ها برای یک شاخه خاص؛ <branch-name> را با نام واقعی شاخه جایگزین کنید
$ gh cache list --ref refs/heads/<branch-name>

# فهرست کردن کش‌ها برای یک درخواست ادغام خاص؛ <pr-number> را با شماره واقعی درخواست ادغام جایگزین کنید
$ gh cache list --ref refs/pull/<pr-number>/merge

.EE


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