.TH "kitten-@-launch" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-launch \- اجرای یک فرایند دلخواه در یک پنجره یا برگه جدید
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ launch  [CMD ...]"
.YS
.SH "توضیحات (DESCRIPTION)"
شناسه (id) پنجره تازه بازشده را در خروجی چاپ می‌کند. هرگونه آرگومان خط فرمان به عنوان دستوری برای اجرا در پنجره جدید تلقی می‌شود؛ در صورتی که هیچ آرگومانی ارائه نشود، شل پیش‌فرض اجرا خواهد شد. برای مثال::


    kitten @ launch \-\-title=Email mutt
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m" 
برگه‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت 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) مشخص‌شده ایجاد شده‌اند تطبیق می‌دهد. از عبارت \(ha$ برای تطبیق پنجره‌هایی که در یک نشست ایجاد نشده‌اند استفاده کنید؛ از . برای تطبیق نشست فعال فعلی و از \(ti برای تطبیق نشست فعال فعلی یا آخرین نشست فعال در زمانی که هیچ نشستی فعال نیست استفاده نمایید.

هنگام استفاده از فیلد 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 برای دریافت فهرستی از برگه‌ها استفاده کنید.
.TP
.BI "--wait-for-child-to-exit" " [=no]"
صبر کردن تا زمانی که برنامه راه‌اندازی‌شده خاتمه یابد و چاپ کد خروج آن. کد خروج به جای شناسه پنجره چاپ می‌شود. اگر برنامه به طور عادی خارج شود، کد خروج آن چاپ می‌شود که همواره بزرگتر یا مساوی صفر است. اگر برنامه با یک سیگنال متوقف شده باشد، نام نمادین SIGNAL در صورت وجود چاپ می‌شود، در غیر این صورت شماره سیگنال با یک علامت منفی چاپ خواهد شد.
.TP
.BI "--response-timeout" " [=86400]"
مدت زمان به ثانیه برای انتظار جهت پایان یافتن فرایند آغازشده، در هنگام استفاده از گزینه 
.B \-\-wait\-for\-child\-to\-exit.
پیش‌فرض یک روز است.
.TP
.BI "--no-response" " [=no]"
شناسه پنجره تازه‌ساخته‌شده چاپ نشود.
.TP
.BI "--self" " [=no]"
در صورت مشخص شدن، برگه‌ای که پنجره اجرای این دستور در آن قرار دارد به جای برگه فعال استفاده می‌شود.
.TP
.BI "--source-window" 
یک عبارت تطبیق برای انتخاب پنجره‌ای که داده‌هایی مانند عنوان، رنگ‌ها، متغیرهای محیطی، محتویات صفحه و غیره از آن رونویسی می‌شوند. در صورت عدم تعیین، از پنجره فعال کنونی استفاده می‌شود. برای نحو مشخص‌سازی پنجره‌ها به search_syntax مراجعه کنید.
.TP
.BI "--title, --window-title" 
عنوان برای تنظیم روی پنجره جدید. به طور پیش‌فرض، عنوان توسط فرایند فرزند کنترل می‌شود. مقدار ویژه current عنوان را از 
.B \-\-source\-window
رونویسی می‌کند.
.TP
.BI "--tab-title" 
عنوان برگه جدید در صورت راه‌اندازی در یک برگه تازه. به طور پیش‌فرض عنوان پنجره فعال در برگه به عنوان عنوان برگه استفاده می‌شود. مقدار ویژه current عنوان را از برگه حاوی 
.B \-\-source\-window
کپی می‌کند.
.TP
.BI "--type" " [=window]"
محل راه‌اندازی فرایند فرزند:

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

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

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

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

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

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

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

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



انتخاب‌ها: window, background, clipboard, os-panel, os-window, overlay, overlay-main, primary, tab
.TP
.BI "--dont-take-focus, --keep-focus" " [=no]"
حفظ فوکوس روی پنجره فعال جاری به جای تغییر فوکوس به پنجره تازه بازشده.
.TP
.BI "--cwd" 
دایرکتوری کاری برای فرزند تازه راه‌اندازی‌شده. از مقدار ویژه current برای استفاده از دایرکتوری کاری 
.B \-\-source\-window
استفاده کنید. مقدار ویژه last_reported از آخرین دایرکتوری کاری گزارش‌شده توسط شل استفاده می‌کند (برای کارکرد نیاز به shell_integration دارد). مقدار ویژه oldest مانند current عمل می‌کند اما از دایرکتوری کاری قدیمی‌ترین فرایند پیش‌زمینه مرتبط با پنجره فعال جاری به جای جدیدترین فرایند پیش‌زمینه استفاده می‌کند. در نهایت، مقدار ویژه root به فرایندی اشاره دارد که ابتدا هنگام ایجاد پنجره آغاز شده بود.

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

انتخاب‌ها: default, after, before, first, hsplit, last, neighbor, split, vsplit
.TP
.BI "--next-to" 
یک عبارت تطبیق برای انتخاب پنجره‌ای که پنجره جدید در کنار آن ایجاد می‌شود. برای نحو تعیین پنجره‌ها به search_syntax مراجعه کنید. در صورت عدم تعیین، به طور پیش‌فرض پنجره فعال انتخاب می‌شود. در هنگام استفاده از طریق کنترل از راه دور، این گزینه نادیده گرفته می‌شود مگر اینکه پنجره منطبق در برگه هدف (به طور پیش‌فرض برگه فعال) باشد. هنگام استفاده از 
.B \-\-type
با مقدار tab، برگه در پنجره سیستم‌عامل حاوی پنجره منطبق ایجاد خواهد شد.
.TP
.BI "--bias" " [=0]"
میزان اریبی (bias) مورد استفاده برای تغییر اندازه پنجره. این گزینه تعیین می‌کند پنجره چه کسری از فضای موجود را اشغال کند. معنای دقیق bias به چیدمان جاری بستگی دارد.

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

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

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

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

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

گزینه bias در نسخه 0.36.0 کیتی معرفی شد.
.TP
.BI "--allow-remote-control" " [=no]"
برنامه‌های در حال اجرا در این پنجره می‌توانند kitty را کنترل کنند (حتی اگر کنترل از راه دور در 
.I kitty.conf
فعال نشده باشد). توجه داشته باشید هر برنامه‌ای با سطح دسترسی مناسب همچنان می‌تواند روی پایپ‌های هر برنامه دیگری در همان رایانه بنویسد و بنابراین کیتی را کنترل کند. با این حال، می‌تواند برای مسدود کردن برنامه‌های در حال اجرا در رایانه‌های دیگر (مثلاً از طریق SSH) یا سایر کاربران مفید باشد. به 
.B \-\-remote\-control\-password
برای راه‌های محدود کردن اقدامات مجاز از طریق کنترل از راه دور مراجعه کنید.
.TP
.BI "--remote-control-password" 
محدود کردن اقداماتی که کنترل از راه دور مجاز به انجام آن‌ها است. این گزینه مانند 
.B remote_control_password
عمل می‌کند. می‌توانید یک گذرواژه و فهرستی از اقدامات را دقیقاً مانند 
.B remote_control_password
مشخص کنید. برای مثال::


    \-\-remote\-control\-password \[aq]\[dq]my passphrase\[dq] get\-* set\-colors\[aq]

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


    \-\-remote\-control\-password \[aq]!\[aq]

این گزینه تنها زمانی اثرگذار است که 
.B \-\-allow\-remote\-control
نیز مشخص شده باشد. می‌تواند چندین بار برای ایجاد چندین گذرواژه مشخص شود. این گزینه در نسخه 0.26.0 به kitty اضافه شد.
.TP
.BI "--stdin-source" " [=none]"
ارسال محتویات صفحه به عنوان 
.I STDIN
به فرایند فرزند.

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

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

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

@alternate
    صفحه ثانویه در 
.B \-\-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
.TP
.BI "--stdin-add-formatting" " [=no]"
هنگام استفاده از 
.B \-\-stdin\-source
کدهای گریز قالب‌بندی (formatting escape codes) اضافه شوند؛ بدون این گزینه تنها متن خام ساده ارسال خواهد شد.
.TP
.BI "--stdin-add-line-wrap-markers" " [=no]"
هنگام استفاده از 
.B \-\-stdin\-source
یک کاراکتر بازگشت به سر سطر (carriage return) در هر نقطه شکست خط (جایی که خطوط طولانی در لبه صفحه شکسته می‌شوند) اضافه شود. این گزینه زمانی مفید است که می‌خواهید خروجی را به برنامه‌ای پایپ کنید که قصد دارد چینش نمایشی صفحه را بازتولید کند.
.TP
.BI "--marker" 
ایجاد یک نشانگر (marker) که متن را در پنجره تازه ایجادشده برجسته می‌کند. نحو آن مشابه اقدام toggle_marker است (به /marks مراجعه کنید).
.TP
.BI "--os-window-class" 
تنظیم ویژگی WM_CLASS در X11 و ویژگی شناسه برنامه (application id) در Wayland برای پنجره تازه ساخته‌شده سیستم‌عامل هنگام استفاده از 
.B \-\-type.
به طور پیش‌فرض روی هر آنچه فرایند والد کیتی استفاده می‌کند تنظیم می‌شود که به نوبه خود پیش‌فرض آن kitty است.
.TP
.BI "--os-window-name" 
تنظیم ویژگی WM_NAME در X11 برای پنجره تازه ساخته‌شده سیستم‌عامل هنگام استفاده از 
.B \-\-type.
پیش‌فرض آن 
.B \-\-os\-window\-class
است.
.TP
.BI "--os-window-title" 
تنظیم عنوان برای پنجره تازه ساخته‌شده سیستم‌عامل. این عنوان بر هر عنوانی که توسط برنامه‌های در حال اجرا در کیتی تنظیم شده باشد اولویت دارد. مقدار ویژه current عنوان را از پنجره سیستم‌عامل حاوی 
.B \-\-source\-window
کپی می‌کند.
.TP
.BI "--os-window-state" " [=normal]"
وضعیت اولیه برای پنجره تازه ساخته‌شده سیستم‌عامل.

انتخاب‌ها: normal, fullscreen, maximized, minimized
.TP
.BI "--os-window-position" 
موقعیت قرارگیری پنجره تازه ساخته‌شده سیستم‌عامل روی صفحه نمایش، برای مثال 10x20. این ویژگی بسته به سیاست‌های محیط میزکار/مدیر پنجره ممکن است کار کند یا نکند. در وی‌لند هرگز کار نمی‌کند.
.TP
.BI "--logo" 
مسیر فایل تصویر PNG برای استفاده به عنوان نشان‌واره (لوگو) در پنجره جدید. به 
.B window_logo_path
مراجعه کنید. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند.
.TP
.BI "--logo-position" 
موقعیت نشان‌واره پنجره. تنها زمانی اثرگذار است که 
.B \-\-logo
تعیین شده باشد. به 
.B window_logo_position
مراجعه فرمایید.
.TP
.BI "--logo-alpha" " [=\-1]"
میزان محوشدگی نشان‌واره پنجره در پس‌زمینه. تنها در صورتی اثر دارد که 
.B \-\-logo
مشخص شده باشد. به 
.B window_logo_alpha
مراجعه فرمایید.
.TP
.BI "--color" 
تغییر رنگ‌ها در پنجره تازه راه‌اندازی‌شده. می‌توانید یک مسیر به فایل 
.I .conf
با همان نحو 
.I kitty.conf
برای خواندن رنگ‌ها از آن مشخص کنید، یا آن‌ها را به صورت تک‌تک تعیین نمایید، برای مثال::


    \-\-color background=white \-\-color foreground=red
.TP
.BI "--spacing" 
تنظیم حاشیه و فاصله‌گذاری بیرونی و درونی (margin و padding) برای پنجره جدید. برای مثال: margin=20 یا padding\-left=10 یا margin\-h=30. شکل خلاصه همه مقادیر را تنظیم می‌کند؛ انواع *\-h و *\-v مقادیر افقی و عمودی را تعیین می‌کنند. می‌تواند چندین بار مشخص شود. توجه داشته باشید این گزینه برای پنجره‌های لایه رویی (overlay) نادیده گرفته می‌شود زیرا آن‌ها از تنظیمات پنجره پایه استفاده می‌کنند.
.TP
.BI "--watcher, -w" 
مسیر فایل پایتون. توابعی با نام‌گذاری مناسب در این فایل برای رویدادهای مختلف فراخوانی می‌شوند، مانند زمانی که اندازه پنجره تغییر می‌کند، فوکوس می‌گیرد یا بسته می‌شود. به بخش دیده‌بان‌ها (watchers) در مستندات دستور launch مراجعه کنید. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند. دیده‌بان‌های سراسری برای تمام پنجره‌ها را می‌توان با 
.B watcher
در 
.I kitty.conf
تعیین کرد.
.TP
.BI "--os-panel" 
گزینه‌هایی برای کنترل ایجاد پنل‌های میزکار. همان تنظیمات برنامه جانبی panel را می‌پذیرد، به جز 
.B \-\-override
و 
.B \-\-config.
می‌تواند چندین بار مشخص شود. برای مثال، برای ایجاد یک پنل دسکتاپ در پایین صفحه با ارتفاع دو خط::


    launch \-\-type os\-panel \-\-os\-panel lines=2 \-\-os\-panel edge=bottom sh \-c \[dq]echo; echo; echo hello; sleep 5s\[dq]
.TP
.BI "--hold-after-ssh" " [=no]"
هنگام استفاده از 
.B \-\-cwd=current
یا موارد مشابه از پنجره‌ای که در حال اجرای برنامه جانبی ssh kitten است، در صورت تعیین این گزینه، پنجره جدید پس از قطع ارتباط از میزبان راه‌دور یک شل محلی را اجرا خواهد کرد.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to" 
نشانی نمونه کیتی برای کنترل آن. متناظر با نشانی داده‌شده به نمونه کیتی از طریق گزینه 
.B \-\-listen\-on
یا تنظیم 
.B listen_on
در 
.I kitty.conf
است. در صورت عدم تعیین، متغیر محیطی 
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده برای این فرایند فرستاده می‌شوند، یعنی این دستور تنها در صورتی کار می‌کند که این فرایند درون پنجره کیتی اجرا شود.
.TP
.BI "--password" 
گذرواژه برای استفاده هنگام ارتباط با کیتی. این باعث می‌شود کیتی برای انجام اقدام مشخص‌شده از کاربر اجازه بخواهد، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا در 
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از یک گذرواژه خالی، گزینه 
.B \-\-use\-password
را روی always تنظیم کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی کیتی سنجیده می‌شوند. از \- برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل با شماره num استفاده نمایید. در صورتی استفاده می‌شود که گزینه‌ای برای 
.B \-\-password
ارائه نشده باشد. به طور پیش‌فرض وجود فایل 
.I rc\-pass
در دایرکتوری پیکربندی کیتی بررسی می‌شود.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که 
.B \-\-password\-file
داده نشده باشد. به طور پیش‌فرض متغیر محیطی 
.B KITTY_RC_PASSWORD
بررسی می‌شود.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار آن به استفاده همیشگی (always) یا هرگز استفاده نکردن (never) از گذرواژه داده‌شده به کار رود. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشده باشد، گذرواژه خالی استفاده می‌شود.

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