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



نام (NAME)
       gh-search-commits - جستجوی کامیت‌ها



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



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


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


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

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


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



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


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


       --author-email <string>
              فیلتر کردن بر اساس ایمیل نویسنده


       --author-name <string>
              فیلتر کردن بر اساس نام نویسنده


       --committer <string>
              فیلتر کردن بر اساس ثبت‌کننده کامیت (committer)


       --committer-date <date>
              فیلتر کردن بر اساس تاریخ ثبت کامیت


       --committer-email <string>
              فیلتر کردن بر اساس ایمیل ثبت‌کننده کامیت


       --committer-name <string>
              فیلتر کردن بر اساس نام ثبت‌کننده کامیت


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


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


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


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


       --merge
              فیلتر کردن بر اساس کامیت‌های ادغام (merge)


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


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


       --parent <string>
              فیلتر کردن بر اساس هش والد (parent)


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


       --sort <string> (default "best-match")
              مرتب‌سازی کامیت‌های واکشی‌شده: {author-date|committer-date}


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


       --tree <string>
              فیلتر کردن بر اساس هش درخت (tree)


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


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



فیلدهای JSON (JSON FIELDS)
       author, commit, committer, id, parents, repository, sha, url



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


       1: خطا


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


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


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



مثال‌ها (EXAMPLES)
       # جستجوی کامیت‌های منطبق با مجموعه‌ای از کلیدواژه‌های "readme" و "typo"
       $ gh search commits readme typo

       # جستجوی کامیت‌های منطبق با عبارت "bug fix"
       $ gh search commits "bug fix"

       # جستجوی کامیت‌ها با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
       $ gh search commits fix author:monalisa merge:false

       # جستجوی کامیت‌های ثبت‌شده توسط کاربر "monalisa"
       $ gh search commits --committer=monalisa

       # جستجوی کامیت‌های نگارش‌شده توسط کاربران با نام "Jane Doe"
       $ gh search commits --author-name="Jane Doe"

       # جستجوی کامیت‌های منطبق با هش "8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3"
       $ gh search commits --hash=8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3

       # جستجوی کامیت‌های نگارش‌شده پیش از ۱ فوریه ۲۰۲۲
       $ gh search commits --author-date="<2022-02-01"




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

                                   Sep 2026               GH-SEARCH-COMMITS(1)