kitten-@-launch(1) kitten Manual kitten-@-launch(1)

kitten-@-launch - اجرای یک فرایند دلخواه در یک پنجره یا برگه جدید

kitten @ launch [CMD ...]

شناسه (id) پنجره تازه بازشده را در خروجی چاپ می‌کند. هرگونه آرگومان خط فرمان به عنوان دستوری برای اجرا در پنجره جدید تلقی می‌شود؛ در صورتی که هیچ آرگومانی ارائه نشود، شل پیش‌فرض اجرا خواهد شد. برای مثال::


kitten @ launch --title=Email mutt

برگه‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت field:query هستند. که در آن field می‌تواند یکی از این موارد باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. بخش query عبارت مورد نظر برای تطبیق است. عبارات می‌توانند یک عدد یا یک عبارت باقاعده باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

مقدار ویژه all تمامی برگه‌ها را مطابقت می‌دهد.

برای فیلدهای عددی: id، index، window_id، pid و recent، عبارت به عنوان عدد تفسیر می‌شود و نه عبارت باقاعده. مقادیر منفی برای id/window_id از بالاترین شماره شناسه به پایین تطبیق می‌یابند؛ به ویژه مقدار -1 جدیدترین برگه/پنجره ایجادشده است.

هنگام استفاده از title یا id، ابتدا به دنبال یک برگه منطبق جستجو می‌شود، و در صورت پیدا نشدن، به دنبال یک پنجره منطبق گشته و برگه حاوی آن پنجره استفاده می‌شود.

همچنین می‌توانید از window_id و window_title برای تطبیق برگه‌ای که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.

شماره index برای تطبیق n-اُمین برگه در پنجره فعال کنونی سیستم‌عامل استفاده می‌شود. شماره recent برگه‌هایی را که اخیراً فعال بوده‌اند در پنجره فعال سیستم‌عامل تطبیق می‌دهد، به طوری که صفر برگه فعال جاری، یک برگه فعال قبلی و به همین ترتیب خواهد بود.

فیلد session برگه‌هایی را که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌دهد. از عبارت ^$ برای تطبیق پنجره‌هایی که در یک نشست ایجاد نشده‌اند استفاده کنید؛ از . برای تطبیق نشست فعال فعلی و از ~ برای تطبیق نشست فعال فعلی یا آخرین نشست فعال در زمانی که هیچ نشستی فعال نیست استفاده نمایید.

هنگام استفاده از فیلد env برای تطبیق روی متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، مانند env:MY_ENV_VAR=2. برگه‌های حاوی هر پنجره‌ای با متغیرهای محیطی مشخص‌شده تطبیق داده می‌شوند. به طور مشابه، var برگه‌های حاوی هر پنجره‌ای با متغیر کاربری مشخص‌شده را تطبیق می‌دهد.

فیلد state بر اساس وضعیت برگه تطبیق می‌دهد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused و focused_os_window. برگه‌های active برگه‌هایی هستند که در پنجره والد سیستم‌عامل خود فعال می‌باشند. تنها یک برگه focused وجود دارد و آن برگه‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ برگه‌ای فوکوس نداشته باشد، آخرین برگه دارای فوکوس تطبیق داده می‌شود. مقدار focused_os_window تمام برگه‌ها را در پنجره دارای فوکوس کنونی سیستم‌عامل مطابقت می‌دهد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرستی از برگه‌ها استفاده کنید.

صبر کردن تا زمانی که برنامه راه‌اندازی‌شده خاتمه یابد و چاپ کد خروج آن. کد خروج به جای شناسه پنجره چاپ می‌شود. اگر برنامه به طور عادی خارج شود، کد خروج آن چاپ می‌شود که همواره بزرگتر یا مساوی صفر است. اگر برنامه با یک سیگنال متوقف شده باشد، نام نمادین SIGNAL در صورت وجود چاپ می‌شود، در غیر این صورت شماره سیگنال با یک علامت منفی چاپ خواهد شد.
مدت زمان به ثانیه برای انتظار جهت پایان یافتن فرایند آغازشده، در هنگام استفاده از گزینه --wait-for-child-to-exit. پیش‌فرض یک روز است.
شناسه پنجره تازه‌ساخته‌شده چاپ نشود.
در صورت مشخص شدن، برگه‌ای که پنجره اجرای این دستور در آن قرار دارد به جای برگه فعال استفاده می‌شود.
یک عبارت تطبیق برای انتخاب پنجره‌ای که داده‌هایی مانند عنوان، رنگ‌ها، متغیرهای محیطی، محتویات صفحه و غیره از آن رونویسی می‌شوند. در صورت عدم تعیین، از پنجره فعال کنونی استفاده می‌شود. برای نحو مشخص‌سازی پنجره‌ها به search_syntax مراجعه کنید.
عنوان برای تنظیم روی پنجره جدید. به طور پیش‌فرض، عنوان توسط فرایند فرزند کنترل می‌شود. مقدار ویژه current عنوان را از --source-window رونویسی می‌کند.
عنوان برگه جدید در صورت راه‌اندازی در یک برگه تازه. به طور پیش‌فرض عنوان پنجره فعال در برگه به عنوان عنوان برگه استفاده می‌شود. مقدار ویژه current عنوان را از برگه حاوی --source-window کپی می‌کند.
محل راه‌اندازی فرایند فرزند:

window
یک پنجره جدید kitty در برگه جاری

tab
یک برگه جدید در پنجره جاری سیستم‌عامل. هنگام استفاده از دستور launch در نشست‌های راه‌اندازی در دسترس نیست.

os-window
یک پنجره جدید سیستم‌عامل. هنگام استفاده از دستور launch در نشست‌های راه‌اندازی در دسترس نیست.

overlay
یک پنجره لایه رویی (overlay) که پنجره فعال کنونی kitty را می‌پوشاند

overlay-main
یک پنجره رویی که پنجره فعال کنونی kitty را می‌پوشاند. برخلاف پنجره‌های overlay معمولی، این پنجره به عنوان پنجره اصلی در نظر گرفته می‌شود؛ بدین معنی که به عنوان پنجره فعال برای دریافت دایرکتوری کاری جاری، متن ورودی برای kittenها، دستورات launch و غیره استفاده می‌شود. در صورتی که قرار است این لایه رویی برای مدت طولانی به عنوان پنجره اصلی اجرا شود، بسیار مفید است.

background
فرایند در پس‌زمینه و بدون پنجره kitty اجرا خواهد شد. توجه داشته باشید اگر --allow-remote-control مشخص شده باشد، متغیر محیطی KITTY_LISTEN_ON روی یک توصیف‌گر فایل جفت‌سوکت اختصاصی تنظیم می‌شود که فرایند می‌تواند از آن برای کنترل از راه دور استفاده کند.

clipboard, primary
این دو مقدار برای کار با --stdin-source جهت رونوشت داده‌ها به کلیپ‌بورد سیستم یا بخش گزینش اولیه در نظر گرفته شده‌اند.

os-panel
مشابه os-window است، با این تفاوت که پنجره جدید سیستم‌عامل را به عنوان یک پنل دسکتاپ ایجاد می‌کند. تنها روی بسترهایی که از این قابلیت پشتیبانی می‌کنند کار می‌کند، مانند کامپوزیتورهای وی‌لند که از پروتکل layer shell پشتیبانی می‌نمایند. از گزینه --os-panel برای پیکربندی پنل استفاده کنید.

انتخاب‌ها: window, background, clipboard, os-panel, os-window, overlay, overlay-main, primary, tab

حفظ فوکوس روی پنجره فعال جاری به جای تغییر فوکوس به پنجره تازه بازشده.
دایرکتوری کاری برای فرزند تازه راه‌اندازی‌شده. از مقدار ویژه current برای استفاده از دایرکتوری کاری --source-window استفاده کنید. مقدار ویژه last_reported از آخرین دایرکتوری کاری گزارش‌شده توسط شل استفاده می‌کند (برای کارکرد نیاز به shell_integration دارد). مقدار ویژه oldest مانند current عمل می‌کند اما از دایرکتوری کاری قدیمی‌ترین فرایند پیش‌زمینه مرتبط با پنجره فعال جاری به جای جدیدترین فرایند پیش‌زمینه استفاده می‌کند. در نهایت، مقدار ویژه root به فرایندی اشاره دارد که ابتدا هنگام ایجاد پنجره آغاز شده بود.

هنگامی که باز کردن پنجره جدید در همان دایرکتوری کاری پنجره فعلی باعث اتصال پنجره جدید به یک میزبان راه‌دور شود، می‌توانید از فلگ --hold-after-ssh برای جلوگیری از بسته شدن پنجره جدید هنگام قطع اتصال استفاده کنید.

افزودن پنجره/برگه تازه ایجادشده به نشست مشخص‌شده. از . برای افزودن به نشست --source-window (در صورت وجود) استفاده کنید. برای اطلاع از اینکه نشست چیست و چگونه استفاده می‌شود به بخش sessions مراجعه فرمایید. به طور پیش‌فرض، زمانی که --cwd برای استفاده از دایرکتوری کاری آن پنجره تنظیم شده باشد، پنجره به نشست --source-window افزوده می‌شود، در غیر این صورت پنجره تازه‌ساخته‌شده به هیچ نشستی تعلق ندارد. برای اجبار به عدم افزودن به هیچ نشستی، از مقدار ! استفاده کنید. افزودن یک پنجره تازه ایجادشده به یک نشست کاملاً موقتی است و فایل واقعی نشست را تغییر نمی‌دهد؛ برای این کار باید نشست را دوباره ذخیره کنید. توجه داشته باشید استفاده از این فلگ در یک دستور launch در داخل یک فایل نشست هیچ تاثیری ندارد زیرا پنجره همواره به نشست متعلق به آن فایل اضافه می‌شود.
متغیرهای محیطی برای تنظیم در فرایند فرزند. می‌تواند چندین بار برای تنظیم متغیرهای محیطی مختلف مشخص شود. نحو: name=value. استفاده از name= مقدار را روی رشته خالی تنظیم می‌کند و صرفاً name متغیر محیطی را حذف خواهد کرد.
متغیرهای کاربری برای تنظیم در پنجره ایجادشده. می‌تواند چندین بار برای تنظیم متغیرهای کاربری گوناگون مشخص شود. نحو: name=value. استفاده از name= مقدار را روی رشته خالی تنظیم خواهد کرد.
باز نگه داشتن پنجره حتی پس از خروج دستورِ در حال اجرا، در اعلان خط فرمان شل. شل پس از خروج دستور راه‌اندازی‌شده اجرا خواهد شد.
تنظیم رنگ‌های پنجره تازه ایجادشده مشابه رنگ‌های موجود در --source-window.
نادیده گرفتن هرگونه خط فرمان مشخص‌شده و استفاده از خط فرمان --source-window به جای آن.
کپی کردن متغیرهای محیطی از --source-window به درون فرایند فرزند تازه راه‌اندازی‌شده. توجه داشته باشید این گزینه تنها محیط را در زمان ایجاد اولیه پنجره کپی می‌کند، زیرا دریافت متغیرهای محیطی به‌روزشده از فرایندهای دلخواه امکان‌پذیر نیست. به ویژه، این بدان معناست که اگر شلی را در پنجره اجرا می‌کنید و شل متغیرهای محیطی را در فایل‌های rc خود تنظیم کرده باشد، این متغیرها کپی **نخواهند شد**. برای رونوشت آن محیط، یا از ویژگی clone-in-kitty یا از ویژگی کنترل از راه دور kitty با --copy-env استفاده کنید.
محل قرارگیری پنجره تازه ایجادشده هنگام افزودن به برگه‌ای که در حال حاضر دارای پنجره‌های موجود است. مقادیر after و before پنجره جدید را قبل یا بعد از پنجره فعال قرار می‌دهند. مقدار neighbor مترادفی برای after است. همچنین در ایجاد برگه جدید نیز اعمال می‌شود، که در آن مقدار after باعث می‌شود برگه جدید به جای قرار گرفتن در انتها، در کنار برگه جاری قرار گیرد. مقادیر vsplit، hsplit و split تنها توسط چیدمان splits استفاده می‌شوند و تعیین می‌کنند که پنجره جدید در یک تقسیم عمودی، افقی یا خودکار با پنجره فعال کنونی قرار گیرد. حالت پیش‌فرض قرار دادن پنجره به شیوه‌ای وابسته به چیدمان است که معمولاً پس از پنجره فعال فعلی قرار می‌گیرد. به --next-to برای استفاده از پنجره‌ای به جز پنجره فعال فعلی مراجعه کنید.

انتخاب‌ها: default, after, before, first, hsplit, last, neighbor, split, vsplit

یک عبارت تطبیق برای انتخاب پنجره‌ای که پنجره جدید در کنار آن ایجاد می‌شود. برای نحو تعیین پنجره‌ها به search_syntax مراجعه کنید. در صورت عدم تعیین، به طور پیش‌فرض پنجره فعال انتخاب می‌شود. در هنگام استفاده از طریق کنترل از راه دور، این گزینه نادیده گرفته می‌شود مگر اینکه پنجره منطبق در برگه هدف (به طور پیش‌فرض برگه فعال) باشد. هنگام استفاده از --type با مقدار tab، برگه در پنجره سیستم‌عامل حاوی پنجره منطبق ایجاد خواهد شد.
میزان اریبی (bias) مورد استفاده برای تغییر اندازه پنجره. این گزینه تعیین می‌کند پنجره چه کسری از فضای موجود را اشغال کند. معنای دقیق bias به چیدمان جاری بستگی دارد.

* چیدمان Splits: مقدار اریبی به عنوان یک درصد بین 0 و 100 تفسیر می‌شود. هنگام تقسیم یک پنجره به دو بخش، پنجره جدید کسر مشخص‌شده‌ای از فضای اختصاص‌یافته به پنجره اصلی را اشغال می‌کند و پنجره اصلی باقیمانده فضا را در بر می‌گیرد.

* چیدمان Vertical/horizontal: مقدار اریبی به عنوان افزودن/کاستن از اندازه عادی پنجره تفسیر می‌شود. این مقدار باید عددی بین -90 و 90 باشد. این عدد درصدی از اندازه پنجره سیستم‌عامل است که باید به اندازه پنجره افزوده شود. بنابراین به عنوان مثال، اگر یک پنجره در چیدمان داخل یک پنجره سیستم‌عامل به ارتفاع 80، به طور عادی اندازه 50 می‌داشت و از --bias -10 استفاده شود، اندازه ارتفاع آن *تقریباً* به 42 تغییر می‌یابد. توجه داشته باشید که اندازه‌ها تقریبی هستند و نمی‌توانید از این روش برای ایجاد پنجره‌هایی با اندازه‌های ثابت استفاده کنید.

* چیدمان Tall: اگر پنجره در حال ساخت *نخستین* پنجره در یک ستون باشد، مقدار اریبی مانند چیدمان splits به صورت درصد تفسیر می‌شود و عرض پنجره سیستم‌عامل را میان ستون‌ها تقسیم می‌کند. اگر پنجره، پنجره دوم یا بعدی در یک ستون باشد، اریبی به عنوان افزودن/کاستن از اندازه پنجره مانند چیدمان عمودی در بالا تفسیر می‌شود.

* چیدمان Fat: مشابه چیدمان tall است با این تفاوت که به جای ستون‌ها بر مبنای ردیف‌ها عمل می‌کند.

* چیدمان Grid: اریبی به همان شیوه چیدمان‌های عمودی و افقی، به عنوان مقداری برای افزایش/کاهش اندازه عادی تفسیر می‌شود. با این حال، از آنجا که در چیدمان شبکه‌ای هم ردیف و هم ستون وجود دارد، اریبی روی نخستین پنجره در یک ستون روی ستون‌ها عمل می‌کند. هر پنجره بعدی در آن ستون روی ردیف عمل خواهد کرد. بنابراین، به عنوان مثال، اگر به اولین پنجره در یک چیدمان شبکه‌ای اریبی بدهید، عرض ستون اول تغییر خواهد کرد؛ پنجره دوم، عرض ستون دوم؛ پنجره سوم، ارتفاع ردیف دوم و به همین ترتیب.

گزینه bias در نسخه 0.36.0 کیتی معرفی شد.

برنامه‌های در حال اجرا در این پنجره می‌توانند kitty را کنترل کنند (حتی اگر کنترل از راه دور در kitty.conf فعال نشده باشد). توجه داشته باشید هر برنامه‌ای با سطح دسترسی مناسب همچنان می‌تواند روی پایپ‌های هر برنامه دیگری در همان رایانه بنویسد و بنابراین کیتی را کنترل کند. با این حال، می‌تواند برای مسدود کردن برنامه‌های در حال اجرا در رایانه‌های دیگر (مثلاً از طریق SSH) یا سایر کاربران مفید باشد. به --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 اضافه شد.

ارسال محتویات صفحه به عنوان STDIN به فرایند فرزند.

@selection
متن در حال حاضر انتخاب‌شده در --source-window.

@screen
محتویات صفحه --source-window.

@screen_scrollback
همانند @screen است، اما بافر اسکرول (scrollback) را نیز در بر می‌گیرد.

@alternate
صفحه ثانویه در --source-window. برای مثال اگر یک برنامه ترمینال تمام‌صفحه را اجرا کنید، صفحه ثانویه صفحه‌ای خواهد بود که پس از خروج از برنامه به آن بازمی‌گردید.

@first_cmd_output_on_screen
خروجی نخستین دستور اجراشده در شل روی صفحه.

@last_cmd_output
خروجی آخرین دستور اجراشده در شل.

@last_visited_cmd_output
نخستین خروجی در زیر آخرین موقعیت اسکرول‌شده از طریق scroll_to_prompt است؛ این مورد برای کارکرد به یکپارچه‌سازی شل (shell integration) نیاز دارد.

انتخاب‌ها: none, @alternate, @alternate_scrollback, @first_cmd_output_on_screen, @last_cmd_output, @last_visited_cmd_output, @screen, @screen_scrollback, @selection

هنگام استفاده از --stdin-source کدهای گریز قالب‌بندی (formatting escape codes) اضافه شوند؛ بدون این گزینه تنها متن خام ساده ارسال خواهد شد.
هنگام استفاده از --stdin-source یک کاراکتر بازگشت به سر سطر (carriage return) در هر نقطه شکست خط (جایی که خطوط طولانی در لبه صفحه شکسته می‌شوند) اضافه شود. این گزینه زمانی مفید است که می‌خواهید خروجی را به برنامه‌ای پایپ کنید که قصد دارد چینش نمایشی صفحه را بازتولید کند.
ایجاد یک نشانگر (marker) که متن را در پنجره تازه ایجادشده برجسته می‌کند. نحو آن مشابه اقدام toggle_marker است (به /marks مراجعه کنید).
تنظیم ویژگی WM_CLASS در X11 و ویژگی شناسه برنامه (application id) در Wayland برای پنجره تازه ساخته‌شده سیستم‌عامل هنگام استفاده از --type. به طور پیش‌فرض روی هر آنچه فرایند والد کیتی استفاده می‌کند تنظیم می‌شود که به نوبه خود پیش‌فرض آن kitty است.
تنظیم ویژگی WM_NAME در X11 برای پنجره تازه ساخته‌شده سیستم‌عامل هنگام استفاده از --type. پیش‌فرض آن --os-window-class است.
تنظیم عنوان برای پنجره تازه ساخته‌شده سیستم‌عامل. این عنوان بر هر عنوانی که توسط برنامه‌های در حال اجرا در کیتی تنظیم شده باشد اولویت دارد. مقدار ویژه current عنوان را از پنجره سیستم‌عامل حاوی --source-window کپی می‌کند.
وضعیت اولیه برای پنجره تازه ساخته‌شده سیستم‌عامل.

انتخاب‌ها: normal, fullscreen, maximized, minimized

موقعیت قرارگیری پنجره تازه ساخته‌شده سیستم‌عامل روی صفحه نمایش، برای مثال 10x20. این ویژگی بسته به سیاست‌های محیط میزکار/مدیر پنجره ممکن است کار کند یا نکند. در وی‌لند هرگز کار نمی‌کند.
مسیر فایل تصویر PNG برای استفاده به عنوان نشان‌واره (لوگو) در پنجره جدید. به window_logo_path مراجعه کنید. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند.
موقعیت نشان‌واره پنجره. تنها زمانی اثرگذار است که --logo تعیین شده باشد. به window_logo_position مراجعه فرمایید.
میزان محوشدگی نشان‌واره پنجره در پس‌زمینه. تنها در صورتی اثر دارد که --logo مشخص شده باشد. به window_logo_alpha مراجعه فرمایید.
تغییر رنگ‌ها در پنجره تازه راه‌اندازی‌شده. می‌توانید یک مسیر به فایل .conf با همان نحو kitty.conf برای خواندن رنگ‌ها از آن مشخص کنید، یا آن‌ها را به صورت تک‌تک تعیین نمایید، برای مثال::


--color background=white --color foreground=red

تنظیم حاشیه و فاصله‌گذاری بیرونی و درونی (margin و padding) برای پنجره جدید. برای مثال: margin=20 یا padding-left=10 یا margin-h=30. شکل خلاصه همه مقادیر را تنظیم می‌کند؛ انواع *-h و *-v مقادیر افقی و عمودی را تعیین می‌کنند. می‌تواند چندین بار مشخص شود. توجه داشته باشید این گزینه برای پنجره‌های لایه رویی (overlay) نادیده گرفته می‌شود زیرا آن‌ها از تنظیمات پنجره پایه استفاده می‌کنند.
مسیر فایل پایتون. توابعی با نام‌گذاری مناسب در این فایل برای رویدادهای مختلف فراخوانی می‌شوند، مانند زمانی که اندازه پنجره تغییر می‌کند، فوکوس می‌گیرد یا بسته می‌شود. به بخش دیده‌بان‌ها (watchers) در مستندات دستور launch مراجعه کنید. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند. دیده‌بان‌های سراسری برای تمام پنجره‌ها را می‌توان با watcher در kitty.conf تعیین کرد.
گزینه‌هایی برای کنترل ایجاد پنل‌های میزکار. همان تنظیمات برنامه جانبی panel را می‌پذیرد، به جز --override و --config. می‌تواند چندین بار مشخص شود. برای مثال، برای ایجاد یک پنل دسکتاپ در پایین صفحه با ارتفاع دو خط::


launch --type os-panel --os-panel lines=2 --os-panel edge=bottom sh -c "echo; echo; echo hello; sleep 5s"

هنگام استفاده از --cwd=current یا موارد مشابه از پنجره‌ای که در حال اجرای برنامه جانبی ssh kitten است، در صورت تعیین این گزینه، پنجره جدید پس از قطع ارتباط از میزبان راه‌دور یک شل محلی را اجرا خواهد کرد.
نمایش راهنمای این دستور

نشانی نمونه کیتی برای کنترل آن. متناظر با نشانی داده‌شده به نمونه کیتی از طریق گزینه --listen-on یا تنظیم listen_on در kitty.conf است. در صورت عدم تعیین، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده برای این فرایند فرستاده می‌شوند، یعنی این دستور تنها در صورتی کار می‌کند که این فرایند درون پنجره کیتی اجرا شود.
گذرواژه برای استفاده هنگام ارتباط با کیتی. این باعث می‌شود کیتی برای انجام اقدام مشخص‌شده از کاربر اجازه بخواهد، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از یک گذرواژه خالی، گزینه --use-password را روی always تنظیم کنید.
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل با شماره num استفاده نمایید. در صورتی استفاده می‌شود که گزینه‌ای برای --password ارائه نشده باشد. به طور پیش‌فرض وجود فایل rc-pass در دایرکتوری پیکربندی کیتی بررسی می‌شود.
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که --password-file داده نشده باشد. به طور پیش‌فرض متغیر محیطی KITTY_RC_PASSWORD بررسی می‌شود.
اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار آن به استفاده همیشگی (always) یا هرگز استفاده نکردن (never) از گذرواژه داده‌شده به کار رود. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشده باشد، گذرواژه خالی استفاده می‌شود.

انتخاب‌ها: if-available, always, never

July 30, 2026 0.48.2