kitten-@-run(1)                 راهنمای kitten                 kitten-@-run(1)

نام (NAME)
       kitten-@-run - اجرای برنامه در کامپیوتری که kitty روی آن در حال اجراست
       و دریافت خروجی آن

نحوه استفاده (USAGE)
       kitten @ run  CMD ...

توضیحات (DESCRIPTION)
       اجرای برنامه مشخص‌شده در کامپیوتری که kitty روی آن در حال اجراست. هنگامی
       که STDIN یک TTY نباشد، به عنوان STDIN برنامه به آن ارسال می‌شود.
       خروجی‌های STDOUT و STDERR از برنامه به اینجا هدایت می‌شوند. وضعیت خروج
       این فراخوانی، همان وضعیت خروج برنامه اجراشده خواهد بود. اگر می‌خواهید
       صرفاً برنامه‌ای را بدون انتظار برای پاسخ اجرا کنید، به جای آن از @ launch
       --type=background استفاده کنید.

گزینه‌ها (OPTIONS)
       --env  متغیرهای محیطی برای تنظیم در فرآیند فرزند. می‌توان این گزینه را
              چندین بار برای تنظیم متغیرهای محیطی مختلف مشخص کرد. ساختار:
              name=value. استفاده از name= مقدار را به رشته خالی تنظیم می‌کند و
              صرفاً name متغیر محیطی را حذف خواهد کرد.

       --allow-remote-control [=no]
              برنامه اجراشده دارای دسترسی برای اجرای دستورات کنترل از راه دور
              در kitty خواهد بود.

       --remote-control-password
              محدود کردن عملیاتی که کنترل از راه دور مجاز به انجام آن‌ها است.
              این گزینه مانند remote_control_password عمل می‌کند. می‌توانید یک
              گذرواژه و فهرستی از عملیات‌ها را دقیقاً مانند
              remote_control_password مشخص کنید. برای مثال:

                  --remote-control-password '"my passphrase" get-* set-colors'

              این گذرواژه تنها برای این پنجره معتبر خواهد بود. توجه داشته
              باشید که هر گذرواژه‌ای که برای remote_control_password در
              kitty.conf تعریف کرده‌اید نیز همچنان معتبر است. می‌توانید با
              استفاده از همان گذرواژه در اینجا، آن‌ها را بازنویسی کنید. همچنین
              می‌توانید تمام گذرواژه‌های سراسری remote_control_password را برای
              این پنجره با دستور زیر غیرفعال کنید:

                  --remote-control-password '!'

              این گزینه تنها در صورتی اثرگذار است که --allow-remote-control
              نیز مشخص شده باشد. می‌توان این گزینه را چندین بار برای ایجاد
              چندین گذرواژه مشخص کرد. این گزینه در نسخه 0.26.0 به kitty اضافه
              شد.

       --help, -h [=no]
              نمایش راهنمای این دستور

گزینه‌های عمومی (GLOBAL OPTIONS)
       --to   نشانی نمونه kitty برای کنترل. منطبق بر نشانی داده‌شده به نمونه
              kitty از طریق گزینه --listen-on یا تنظیم listen_on در kitty.conf
              است. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود.
              اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند
              ارسال می‌شوند؛ یعنی تنها در صورتی کار خواهند کرد که این فرآیند
              درون یک پنجره kitty اجرا شود.

       --password
              گذرواژه‌ای برای استفاده هنگام تماس با kitty. این گزینه باعث می‌شود
              kitty برای انجام عمل مشخص‌شده از کاربر اجازه بخواهد، مگر اینکه
              گذرواژه از قبل پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی
              شده باشد. برای استفاده از گذرواژه خالی، --use-password را روی
              always تنظیم کنید.

       --password-file [=rc-pass]
              فایلی برای خواندن گذرواژه از آن. فاصله‌های خالی انتهایی نادیده
              گرفته می‌شوند. مسیرهای نسبی بر مبنای دایرکتوری پیکربندی kitty
              محاسبه می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num
              برای خواندن از توصیف‌کننده فایل num استفاده کنید. در صورت ارائه
              نشدن --password استفاده می‌شود. پیش‌فرض، بررسی فایل rc-pass در
              دایرکتوری پیکربندی kitty است.

       --password-env [=KITTY_RC_PASSWORD]
              نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورت ارائه نشدن
              --password-file استفاده می‌شود. پیش‌فرض، بررسی متغیر محیطی
              KITTY_RC_PASSWORD است.

       --use-password [=if-available]
              اگر گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه
              دور را بدون گذرواژه ارسال می‌کند. از این گزینه می‌توان برای اجبار
              به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده استفاده
              کرد. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشود، از
              گذرواژه خالی استفاده می‌شود.

       گزینه‌های مجاز: if-available, always, never

0.48.2                           July 30, 2026                 kitten-@-run(1)