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

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


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh run watch <run-id> [flags]\fR


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

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

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--compact\fR
نمایش تنها مراحل مرتبط یا ناموفق

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

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


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


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

.PP
1: خطا

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

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

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


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

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

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

.EE


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