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

.SH "نام (NAME)"
gh-pr-list \- فهرست کردن پول‌ریکوئست‌ها در یک مخزن


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


.SH "توضیحات (DESCRIPTION)"
فهرست کردن پول‌ریکوئست‌ها در یک مخزن گیت‌هاب. به‌طور پیش‌فرض، این دستور تنها PRهای باز را فهرست می‌کند.

.PP
نحو عبارت جستجو در اینجا مستند شده است:

\[la]https://docs.github.com/en/search\-github/searching\-on\-github/searching\-issues\-and\-pull\-requests\[ra]

.PP
در میزبان‌های پشتیبانی‌شده گیت‌هاب، می‌توان از نحو جستجوی پیشرفته ایشیو در عبارت
\fB--search\fR استفاده کرد. برای اطلاعات بیشتر درباره جستجوی پیشرفته ایشیو، ببینید:

\[la]https://docs.github.com/en/issues/tracking\-your\-work\-with\-issues/using\-issues/filtering\-and\-searching\-issues\-and\-pull\-requests#building\-advanced\-filters\-for\-issues\[ra]


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--app\fR \fB<string>\fR
فیلتر کردن بر اساس برنامه گیت‌هاب (GitHub App) ایجادکننده

.TP
\fB-a\fR, \fB--assignee\fR \fB<string>\fR
فیلتر کردن بر اساس فرد محول‌شده

.TP
\fB-A\fR, \fB--author\fR \fB<string>\fR
فیلتر کردن بر اساس نویسنده (از --app برای فیلتر کردن بر اساس یک برنامه گیت‌هاب استفاده کنید)

.TP
\fB-B\fR, \fB--base\fR \fB<string>\fR
فیلتر کردن بر اساس شاخه پایه

.TP
\fB-d\fR, \fB--draft\fR
فیلتر کردن بر اساس وضعیت پیش‌نویس (draft)

.TP
\fB-H\fR, \fB--head\fR \fB<string>\fR
فیلتر کردن بر اساس شاخه هد (نحو ":" پشتیبانی نمی‌شود)

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

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

.TP
\fB-l\fR, \fB--label\fR \fB<strings>\fR
فیلتر کردن بر اساس برچسب

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

.TP
\fB-S\fR, \fB--search\fR \fB<query>\fR
جستجوی پول‌ریکوئست‌ها با عبارت جستجو

.TP
\fB-s\fR, \fB--state\fR \fB<string> (default "open")\fR
فیلتر کردن بر اساس وضعیت: {open|closed|merged|all}

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

.TP
\fB-w\fR, \fB--web\fR
فهرست کردن پول‌ریکوئست‌ها در مرورگر وب


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


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


.SH "فیلدهای JSON (JSON FIELDS)"
\fBadditions\fR, \fBassignees\fR, \fBauthor\fR, \fBautoMergeRequest\fR, \fBbaseRefName\fR, \fBbaseRefOid\fR, \fBbody\fR, \fBchangedFiles\fR, \fBclosed\fR, \fBclosedAt\fR, \fBclosingIssuesReferences\fR, \fBcomments\fR, \fBcommits\fR, \fBcreatedAt\fR, \fBdeletions\fR, \fBfiles\fR, \fBfullDatabaseId\fR, \fBheadRefName\fR, \fBheadRefOid\fR, \fBheadRepository\fR, \fBheadRepositoryOwner\fR, \fBid\fR, \fBisCrossRepository\fR, \fBisDraft\fR, \fBlabels\fR, \fBlatestReviews\fR, \fBmaintainerCanModify\fR, \fBmergeCommit\fR, \fBmergeStateStatus\fR, \fBmergeable\fR, \fBmergedAt\fR, \fBmergedBy\fR, \fBmilestone\fR, \fBnumber\fR, \fBpotentialMergeCommit\fR, \fBprojectCards\fR, \fBprojectItems\fR, \fBreactionGroups\fR, \fBreviewDecision\fR, \fBreviewRequests\fR, \fBreviews\fR, \fBstate\fR, \fBstatusCheckRollup\fR, \fBtitle\fR, \fBupdatedAt\fR, \fBurl\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن PRهای ایجادشده توسط شما
$ gh pr list --author "@me"

# فهرست کردن PRهای ایجادشده توسط یک برنامه گیت‌هاب مانند Dependabot
$ gh pr list --app dependabot

# فهرست کردن PRها با یک نام شاخه هد مشخص
$ gh pr list --head "typo"

# فقط فهرست کردن PRهایی که همه برچسب‌های داده‌شده را دارند
$ gh pr list --label bug --label "priority 1"

# فیلتر کردن PRها با استفاده از نحو جستجو
$ gh pr list --search "status:success review:required"

# یافتن PR ایجادکننده یک کامیت مشخص
$ gh pr list --search "<SHA>" --state merged

.EE


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