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

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

gh run list [flags]

فهرست کردن اجراهای اخیر گردش‌کار.

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

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

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

شامل گردش‌های‌کار غیرفعال نیز باشد
فیلتر کردن اجراها بر اساس شاخه
فیلتر کردن اجراها بر اساس شناسه SHA کامیت
فیلتر کردن اجراها بر اساس تاریخ ایجاد آن
فیلتر کردن اجراها بر اساس رویدادی که باعث راه‌اندازی اجرا شده است
فیلتر کردن خروجی JSON با استفاده از عبارت jq
خروجی JSON با فیلدهای مشخص‌شده
حداکثر تعداد اجراها برای دریافت
فیلتر کردن اجراها بر اساس وضعیت: {queued|completed|in_progress|requested|waiting|pending|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}
قالب‌بندی خروجی JSON با استفاده از قالب Go؛ به "gh help formatting" مراجعه کنید
فیلتر کردن اجراها بر اساس کاربری که اجرا را راه‌اندازی کرده است
فیلتر کردن اجراها بر اساس گردش‌کار

انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

gh run ls

attempt, conclusion, createdAt, databaseId, displayTitle, event, headBranch, headSha, name, number, startedAt, status, updatedAt, url, workflowDatabaseId, workflowName

0: اجرای موفقیت‌آمیز

1: خطا

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

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

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

gh-run(1)

Sep 2026