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



نام (NAME)
       gh-run-watch - نظارت بر یک اجرای گردش‌کار تا زمان تکمیل و نمایش پیشرفت
       آن



خلاصه دستور (SYNOPSIS)
       gh run watch <run-id> [flags]



توضیحات (DESCRIPTION)
       نظارت بر یک اجرای گردش‌کار تا زمان تکمیل آن و نمایش پیشرفت.


       به‌طور پیش‌فرض، تمام مراحل نمایش داده می‌شوند. گزینه --compact می‌تواند
       برای نمایش تنها مراحل مرتبط یا ناموفق استفاده شود.


       این دستور از احراز هویت از طریق توکن‌های دسترسی شخصی با دسترسی دقیق
       (fine-grained PATs) پشتیبانی نمی‌کند، زیرا در حال حاضر امکان ساخت یک PAT
       با مجوز checks:read وجود ندارد.



گزینه‌ها (OPTIONS)
       --compact
              نمایش تنها مراحل مرتبط یا ناموفق


       --exit-status
              خروج با وضعیت غیرصفر در صورت ناموفق بودن اجرا


       -i, --interval <int> (default 3)
              فاصله زمانی تازه‌سازی بر حسب ثانیه



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



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


       1: خطا


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


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


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



مثال‌ها (EXAMPLES)
       # نظارت بر یک اجرا تا اتمام آن
       $ gh run watch

       # نظارت بر یک اجرا در حالت فشرده
       $ gh run watch --compact

       # اجرای دستوری دیگر پس از پایان یافتن اجرا
       $ gh run watch && notify-send 'run is done!'




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

                                   Sep 2026                    GH-RUN-WATCH(1)