GH-SEARCH-PRS(1)               GitHub CLI manual              GH-SEARCH-PRS(1)



نام (NAME)
       gh-search-prs - جستجوی درخواست‌های ادغام (Pull Requests)



خلاصه دستور (SYNOPSIS)
       gh search prs [<query>] [flags]



توضیحات (DESCRIPTION)
       جستجوی درخواست‌های ادغام (pull requests) در گیت‌هاب (GitHub).


       این دستور از ساخت پرس‌وجو با استفاده از نحو جستجوی گیت‌هاب، استفاده از
       فلگ‌های پارامتر و توصیف‌کننده (qualifier)، یا ترکیبی از این دو پشتیبانی
       می‌کند.


       نحو جستجوی گیت‌هاب در نشانی زیر مستند شده است:

       ⟨https://docs.github.com/search-github/searching-on-github/searching-issues-and-pull-requests⟩


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

       ⟨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⟩


       برای اطلاعات بیشتر در مورد مدیریت پرس‌وجوهای جستجو حاوی خط پیوند، دستور
       gh search --help را اجرا کنید.



گزینه‌ها (OPTIONS)
       --app <string>
              فیلتر کردن بر اساس سازنده گیت‌هاب اپ (GitHub App)


       --archived
              فیلتر کردن بر اساس وضعیت بایگانی‌شده بودن مخزن {true|false}


       --assignee <string>
              فیلتر کردن بر اساس محول‌شده به شخص (assignee)


       --author <string>
              فیلتر کردن بر اساس نویسنده (از --app برای فیلتر کردن بر اساس یک
              گیت‌هاب اپ استفاده کنید)


       -B, --base <string>
              فیلتر کردن بر اساس نام شاخه پایه (base branch)


       --checks <string>
              فیلتر کردن بر اساس وضعیت بررسی‌ها: {pending|success|failure}


       --closed <date>
              فیلتر کردن بر اساس تاریخ بسته شدن


       --commenter <user>
              فیلتر کردن بر اساس نظرات ثبت‌شده توسط کاربر


       --comments <number>
              فیلتر کردن بر اساس تعداد نظرات


       --created <date>
              فیلتر کردن بر اساس تاریخ ایجاد


       --draft
              فیلتر کردن بر اساس وضعیت پیش‌نویس (draft)


       -H, --head <string>
              فیلتر کردن بر اساس نام شاخه مبدا (head branch)


       --interactions <number>
              فیلتر کردن بر اساس تعداد واکنش‌ها و نظرات


       --involves <user>
              فیلتر کردن بر اساس مشارکت کاربر


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


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


       --label <strings>
              فیلتر کردن بر اساس برچسب


       --language <string>
              فیلتر کردن بر اساس زبان برنامه‌نویسی


       -L, --limit <int> (default 30)
              حداکثر تعداد نتایج برای واکشی


       --locked
              فیلتر کردن بر اساس وضعیت قفل بودن گفتگو


       --match <strings>
              محدود کردن جستجو به فیلد خاصی از مسئله: {title|body|comments}


       --mentions <user>
              فیلتر کردن بر اساس اشاره‌ها (mentions) به کاربر


       --merged
              فیلتر کردن بر اساس وضعیت ادغام‌شده


       --merged-at <date>
              فیلتر کردن بر اساس تاریخ ادغام


       --milestone <title>
              فیلتر کردن بر اساس عنوان مایلستون (milestone)


       --no-assignee
              فیلتر کردن بر اساس نداشتن محول‌شونده (assignee)


       --no-label
              فیلتر کردن بر اساس نداشتن برچسب


       --no-milestone
              فیلتر کردن بر اساس نداشتن مایلستون


       --no-project
              فیلتر کردن بر اساس نداشتن پروژه


       --order <string> (default "desc")
              ترتیب نتایج برگشتی، نادیده گرفته می‌شود مگر اینکه فلگ '--sort'
              مشخص شده باشد: {asc|desc}


       --owner <strings>
              فیلتر کردن بر اساس مالک مخزن


       --project <owner/number>
              فیلتر کردن بر اساس مالک/شماره برد پروژه


       --reactions <number>
              فیلتر کردن بر اساس تعداد واکنش‌ها


       -R, --repo <OWNER/REPO>
              فیلتر کردن بر اساس مخزن، در قالب OWNER/REPO


       --review <string>
              فیلتر کردن بر اساس وضعیت بازبینی:
              {none|required|approved|changes_requested}


       --review-requested <user>
              فیلتر کردن بر اساس کاربر یا تیمی که درخواست بازبینی از آنها شده
              است


       --reviewed-by <user>
              فیلتر کردن بر اساس کاربری که بازبینی کرده است


       --sort <string> (default "best-match")
              مرتب‌سازی نتایج واکشی‌شده:
              {comments|reactions|reactions-+1|reactions--1|reactions-
              smile|reactions-thinking_face|reactions-heart|reactions-
              tada|interactions|created|updated}


       --state <string>
              فیلتر کردن بر اساس وضعیت: {open|closed}


       --team-mentions <string>
              فیلتر کردن بر اساس اشاره‌ها به تیم


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


       --updated <date>
              فیلتر کردن بر اساس تاریخ آخرین به‌روزرسانی


       --visibility <strings>
              فیلتر کردن بر اساس سطح دسترسی مخزن: {public|private|internal}


       -w, --web
              باز کردن عبارت جستجو در مرورگر وب



فیلدهای JSON (JSON FIELDS)
       assignees, author, authorAssociation, body, closedAt, commentsCount,
       createdAt, id, isDraft, isLocked, isPullRequest, labels, number,
       repository, state, title, updatedAt, url



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


       1: خطا


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


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


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



مثال‌ها (EXAMPLES)
       # جستجوی درخواست‌های ادغام منطبق با مجموعه‌ای از کلیدواژه‌های "fix" و "bug"
       $ gh search prs fix bug

       # جستجوی درخواست‌های ادغام پیش‌نویس در مخزن cli
       $ gh search prs --repo=cli/cli --draft

       # جستجوی درخواست‌های ادغام با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
       $ gh search prs is:merged author:monalisa

       # جستجوی درخواست‌های ادغام باز که درخواست بازبینی از شما دارند
       $ gh search prs --review-requested=@me --state=open

       # جستجوی درخواست‌های ادغام ادغام‌شده که به خودتان محول شده‌اند
       $ gh search prs --assignee=@me --merged

       # جستجوی درخواست‌های ادغام با واکنش‌های پرشمار
       $ gh search prs --reactions=">100"

       # جستجوی درخواست‌های ادغام بدون برچسب "bug"
       $ gh search prs -- -label:bug

       # جستجوی درخواست‌های ادغام فقط از مخازن بایگانی‌نشده (پیش‌فرض تمام مخازن است)
       $ gh search prs --owner github --archived=false




همچنین ببینید (SEE ALSO)
       gh-search(1)

                                   Sep 2026                   GH-SEARCH-PRS(1)