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

.SH "نام (NAME)"
gh-search-repos \- جستجوی مخازن


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


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

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

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

\[la]https://docs.github.com/search\-github/searching\-on\-github/searching\-for\-repositories\[ra]

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--archived\fR
فیلتر کردن بر اساس وضعیت بایگانی‌شده بودن مخزن {true|false}

.TP
\fB--created\fR \fB<date>\fR
فیلتر کردن بر اساس تاریخ ایجاد

.TP
\fB--followers\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد دنبال‌کنندگان

.TP
\fB--forks\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد فورک‌ها

.TP
\fB--good-first-issues\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد ایشوهای دارای برچسب 'good first issue'

.TP
\fB--help-wanted-issues\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد ایشوهای دارای برچسب 'help wanted'

.TP
\fB--include-forks\fR \fB<string>\fR
شامل کردن فورک‌ها در مخازن واکشی‌شده: {false|true|only}

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

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

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

.TP
\fB--license\fR \fB<strings>\fR
فیلتر کردن بر اساس نوع مجوز (license)

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

.TP
\fB--match\fR \fB<strings>\fR
محدود کردن جستجو به فیلد خاصی از مخزن: {name|description|readme}

.TP
\fB--number-topics\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد موضوعات (topics)

.TP
\fB--order\fR \fB<string> (default "desc")\fR
ترتیب چینش مخازن بازگردانده‌شده؛ نادیده گرفته می‌شود مگر اینکه فلگ '--sort' مشخص شده باشد: {asc|desc}

.TP
\fB--owner\fR \fB<strings>\fR
فیلتر کردن بر اساس مالک

.TP
\fB--size\fR \fB<string>\fR
فیلتر کردن بر اساس محدوده اندازه، به کیلوبایت

.TP
\fB--sort\fR \fB<string> (default "best-match")\fR
مرتب‌سازی مخازن واکشی‌شده: {forks|help-wanted-issues|stars|updated}

.TP
\fB--stars\fR \fB<number>\fR
فیلتر کردن بر اساس تعداد ستاره‌ها

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

.TP
\fB--topic\fR \fB<strings>\fR
فیلتر کردن بر اساس موضوع

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

.TP
\fB--visibility\fR \fB<strings>\fR
فیلتر کردن بر اساس سطح دسترسی و مشاهده‌پذیری: {public|private|internal}

.TP
\fB-w\fR, \fB--web\fR
باز کردن پرس‌وجوی جستجو در مرورگر وب


.SH "فیلدهای JSON (JSON FIELDS)"
\fBcreatedAt\fR, \fBdefaultBranch\fR, \fBdescription\fR, \fBforksCount\fR, \fBfullName\fR, \fBhasDownloads\fR, \fBhasIssues\fR, \fBhasPages\fR, \fBhasProjects\fR, \fBhasWiki\fR, \fBhomepage\fR, \fBid\fR, \fBisArchived\fR, \fBisDisabled\fR, \fBisFork\fR, \fBisPrivate\fR, \fBlanguage\fR, \fBlicense\fR, \fBname\fR, \fBopenIssuesCount\fR, \fBowner\fR, \fBpushedAt\fR, \fBsize\fR, \fBstargazersCount\fR, \fBupdatedAt\fR, \fBurl\fR, \fBvisibility\fR, \fBwatchersCount\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# جستجوی مخازن منطبق با مجموعه‌ای از کلمات کلیدی "cli" و "shell"
$ gh search repos cli shell

# جستجوی مخازن منطبق با عبارت "vim plugin"
$ gh search repos "vim plugin"

# جستجوی مخازن با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
$ gh search repos topic:github 'stars:>5000'

# جستجوی مخازن عمومی در سازمان مایکروسافت
$ gh search repos --owner=microsoft --visibility=public

# جستجوی مخازن با مجموعه‌ای از موضوعات
$ gh search repos --topic=unix,terminal

# جستجوی مخازن بر اساس زبان برنامه‌نویسی و تعداد ایشوهای good first issue
$ gh search repos --language=go --good-first-issues=">=10"

# جستجوی مخازن بدون موضوع "linux"
$ gh search repos -- -topic:linux

# جستجوی مخازن با حذف مخازن بایگانی‌شده
$ gh search repos --archived=false

.EE


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