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

.SH "نام (NAME)"
gh-run-list \- فهرست کردن اجراهای اخیر گردش‌کار


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh run list [flags]\fR


.SH "توضیحات (DESCRIPTION)"
فهرست کردن اجراهای اخیر گردش‌کار\&.

.PP
توجه داشته باشید که ارائه \fBworkflow_name\fR به گزینه \fB-w\fR، گردش‌های‌کار غیرفعال را دریافت نخواهد کرد\&.
همچنین برای دریافت اجراهای گردش‌های‌کار غیرفعال با استفاده از \fBworkflow_name\fR و گزینه \fB-w\fR، گزینه \fB-a\fR را نیز ارسال کنید\&.

.PP
اجراهای ایجادشده توسط گردش‌های‌کار مجموعه‌قوانین سازمان و سازمانی بزرگ (enterprise) به دلیل محدودیت‌های API گیت‌هاب، نام گردش‌کار را نمایش نخواهند داد\&.

.PP
برای مشاهده اجراهای مرتبط با یک درخواست ادغام (pull request)، کاربران باید دستور \fBgh pr checks\fR را اجرا کنند\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-a\fR, \fB--all\fR
شامل گردش‌های‌کار غیرفعال نیز باشد

.TP
\fB-b\fR, \fB--branch\fR \fB<string>\fR
فیلتر کردن اجراها بر اساس شاخه

.TP
\fB-c\fR, \fB--commit\fR \fB<SHA>\fR
فیلتر کردن اجراها بر اساس شناسه SHA کامیت

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

.TP
\fB-e\fR, \fB--event\fR \fB<event>\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 20)\fR
حداکثر تعداد اجراها برای دریافت

.TP
\fB-s\fR, \fB--status\fR \fB<string>\fR
فیلتر کردن اجراها بر اساس وضعیت: {queued|completed|in_progress|requested|waiting|pending|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}

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

.TP
\fB-u\fR, \fB--user\fR \fB<string>\fR
فیلتر کردن اجراها بر اساس کاربری که اجرا را راه‌اندازی کرده است

.TP
\fB-w\fR, \fB--workflow\fR \fB<string>\fR
فیلتر کردن اجراها بر اساس گردش‌کار


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO


.SH "نام‌های مستعار (ALIASES)"
gh run ls


.SH "فیلدهای JSON (JSON FIELDS)"
\fBattempt\fR, \fBconclusion\fR, \fBcreatedAt\fR, \fBdatabaseId\fR, \fBdisplayTitle\fR, \fBevent\fR, \fBheadBranch\fR, \fBheadSha\fR, \fBname\fR, \fBnumber\fR, \fBstartedAt\fR, \fBstatus\fR, \fBupdatedAt\fR, \fBurl\fR, \fBworkflowDatabaseId\fR, \fBworkflowName\fR


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

.PP
1: خطا

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

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

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


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