.nh
.TH "UPTERM" "1" "May 2026" "Upterm 0.0.0+dev" "Upterm Manual"

.SH "نام (NAME)"
upterm-session-current \- نمایش نشست جاری ترمینال


.SH "خلاصه دستور (SYNOPSIS)"
\fBupterm session current [flags]\fP


.SH "توضیحات (DESCRIPTION)"
نشست جاری ترمینال را نمایش می‌دهد.

.PP
به‌طور پیش‌فرض، مسیر سوکت مدیریتی را از متغیر $UPTERM_ADMIN_SOCKET می‌خواند (که با اجرای دستور 'upterm host' به‌صورت خودکار تنظیم می‌شود).

.PP
سوکت‌ها در این مسیر ذخیره می‌شوند: /build/.upterm

.PP
از مشخصات دایرکتوری پایه XDG پیروی می‌کند و در محیط‌های محدود که دایرکتوری‌های XDG در دسترس نیستند، از $HOME/.upterm به‌عنوان جایگزین پشتیبان استفاده می‌کند.

.PP
قالب‌های خروجی:
  -o json                           خروجی JSON
  -o go-template='{{.ClientCount}}' قالب سفارشی Go

.PP
متغیرهای قالب: SessionID، ClientCount، Host، Command، ForceCommand


.SH "گزینه‌ها (OPTIONS)"
\fB--admin-socket\fP=""
	مسیر سوکت مدیریتی (الزامی).

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای current

.PP
\fB--hide-client-ip\fP[=false]
	مخفی‌سازی آدرس‌های IP کلاینت از خروجی (به‌طور خودکار در محیط‌های CI فعال می‌شود).

.PP
\fB-o\fP, \fB--output\fP=""
	قالب خروجی: json یا go-template='...'


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--debug\fP[=false]
	فعال‌سازی ثبت گزارش در سطح اشکال‌زدایی (فایل گزارش: /build/.upterm/upterm.log).


.SH "مثال‌ها (EXAMPLES)"
.EX
  # نمایش نشست فعال همان‌طور که در $UPTERM_ADMIN_SOCKET تعریف شده است:
  upterm session current

  # خروجی در قالب JSON:
  upterm session current -o json

  # قالب سفارشی برای اعلان خط فرمان (اگر در نشستی نباشد چیزی چاپ نمی‌شود):
  upterm session current -o go-template='🆙 {{.ClientCount}} '

  # برای عنوان ترمینال:
  upterm session current -o go-template='upterm: {{.ClientCount}} clients | {{.SessionID}}'
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBupterm-session(1)\fP


.SH "تاریخچه (HISTORY)"
۶ مه ۲۰۲۶ تولید شده به‌صورت خودکار توسط spf13/cobra