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

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


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


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

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

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

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

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--author\fR \fB<string>\fR
فیلتر کردن بر اساس نویسنده

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

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

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

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

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

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

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

.TP
\fB--hash\fR \fB<string>\fR
فیلتر کردن بر اساس هش کامیت

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

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

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

.TP
\fB--merge\fR
فیلتر کردن بر اساس کامیت‌های ادغام (merge)

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

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

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

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

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

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

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

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

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


.SH "فیلدهای JSON (JSON FIELDS)"
\fBauthor\fR, \fBcommit\fR, \fBcommitter\fR, \fBid\fR, \fBparents\fR, \fBrepository\fR, \fBsha\fR, \fBurl\fR


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

.PP
1: خطا

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

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

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


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

.EE


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