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



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



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



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


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


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

       ⟨https://docs.github.com/search-github/searching-on-github/searching-for-repositories⟩


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



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


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


       --followers <number>
              فیلتر کردن بر اساس تعداد دنبال‌کنندگان


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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



فیلدهای JSON (JSON FIELDS)
       createdAt, defaultBranch, description, forksCount, fullName,
       hasDownloads, hasIssues, hasPages, hasProjects, hasWiki, homepage, id,
       isArchived, isDisabled, isFork, isPrivate, language, license, name,
       openIssuesCount, owner, pushedAt, size, stargazersCount, updatedAt,
       url, visibility, watchersCount



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


       1: خطا


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


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


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



مثال‌ها (EXAMPLES)
       # جستجوی مخازن منطبق با مجموعه‌ای از کلمات کلیدی "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




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

                                   Sep 2026                 GH-SEARCH-REPOS(1)