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

.SH "نام (NAME)"
gh-search \- جستجو برای مخازن، مسائل و درخواست‌های ادغام


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh search <command> [flags]\fR


.SH "توضیحات (DESCRIPTION)"
جستجو در سراسر گیت‌هاب.

.PP
مستثنی کردن نتایج جستجو که با یک توصیف‌کننده (qualifier) مطابقت دارند

.PP
در مرورگر، نحو جستجوی گیت‌هاب از مستثنی کردن نتایجی که با یک توصیف‌کننده جستجو مطابقت دارند، از طریق افزودن خط پیوند (-) به ابتدای توصیف‌کننده پشتیبانی می‌کند. به عنوان مثال، برای جستجوی مسائلی که فاقد برچسب "bug" هستند، می‌توانید از \fB-label:bug\fR به عنوان توصیف‌کننده جستجو استفاده کنید.

.PP
دستور \fBgh\fR نیز از این نحو در \fBgh search\fR پشتیبانی می‌کند، اما برای جلوگیری از تفسیر خط پیوند به عنوان فلگ خط فرمان (چون با یک خط پیوند شروع می‌شود)، به آرگومان‌های خط فرمان اضافی نیاز دارد.

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

.PP
$ gh search issues -- "my-search-query -label:bug"

.PP
در PowerShell، برای ایجاد همین اثر باید هم از آرگومان \fB--%\fR و هم از آرگومان \fB--\fR استفاده کنید. به عنوان مثال:

.PP
$ gh --% search issues -- "my search query -label:bug"

.PP
برای اطلاعات بیشتر به موارد زیر مراجعه کنید:
- نحو جستجوی گیت‌هاب: 
\[la]https://docs.github.com/en/search\-github/getting\-started\-with\-searching\-on\-github/understanding\-the\-search\-syntax#exclude\-results\-that\-match\-a\-qualifier\[ra]
- فلگ توقف تجزیه (stop parse) در PowerShell به صورت \fB--%\fR: 
\[la]https://learn.microsoft.com/en\-us/powershell/module/microsoft.powershell.core/about/about_parsing?view=powershell\-7.5#the\-stop\-parsing\-token\[ra]
- آرگومان \fB--\fR در سیستم‌های شبه‌یونیکس: 
\[la]https://www.gnu.org/software/bash/manual/bash.html#Shell\-Builtin\-Commands\-1\[ra]


.SH "دستورات موجود (AVAILABLE COMMANDS)"
.TP
\fBgh-search-code(1)\fR
جستجو در میان کدها

.TP
\fBgh-search-commits(1)\fR
جستجوی کامیت‌ها

.TP
\fBgh-search-issues(1)\fR
جستجوی مسائل (Issues)

.TP
\fBgh-search-prs(1)\fR
جستجوی درخواست‌های ادغام (Pull Requests)

.TP
\fBgh-search-repos(1)\fR
جستجوی مخازن


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

.PP
1: خطا

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

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

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


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