GH-RUN-LIST(1)                 GitHub CLI manual                GH-RUN-LIST(1)



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



خلاصه دستور (SYNOPSIS)
       gh run list [flags]



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


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


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


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



گزینه‌ها (OPTIONS)
       -a, --all
              شامل گردش‌های‌کار غیرفعال نیز باشد


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


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


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


       -e, --event <event>
              فیلتر کردن اجراها بر اساس رویدادی که باعث راه‌اندازی اجرا شده است


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


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


       -L, --limit <int> (default 20)
              حداکثر تعداد اجراها برای دریافت


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


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


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


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



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



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



فیلدهای JSON (JSON FIELDS)
       attempt, conclusion, createdAt, databaseId, displayTitle, event,
       headBranch, headSha, name, number, startedAt, status, updatedAt, url,
       workflowDatabaseId, workflowName



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


       1: خطا


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


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


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



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

                                   Sep 2026                     GH-RUN-LIST(1)