kitten-@-launch(1) kitten Manual kitten-@-launch(1) (NAME) kitten-@-launch - (USAGE) kitten @ launch [CMD ...] (DESCRIPTION) (id) . . :: kitten @ launch --title=Email mutt (OPTIONS) --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) . ^$ . ~ . 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 . --wait-for-child-to-exit [=no] . . . SIGNAL . --response-timeout [=86400] --wait-for-child-to-exit. . --no-response [=no] . --self [=no] . --source-window . . search_syntax . --title, --window-title . . current --source-window . --tab-title . . current --source-window . --type [=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 --dont-take-focus, --keep-focus [=no] . --cwd . current --source-window . last_reported ( shell_integration ). oldest current . root . --hold-after-ssh . --add-to-session / . . --source-window ( ) . sessions . --cwd --source-window . ! . . launch . --env . . : name=value. name= name . --var . . : name=value. name= . --hold [=no] . . --copy-colors [=no] --source-window. --copy-cmdline [=no] --source-window . --copy-env [=no] --source-window . . rc ** **. clone-in-kitty kitty --copy-env . --location [=default] . after before . neighbor after . after . vsplit hsplit split splits . . --next-to . : default, after, before, first, hsplit, last, neighbor, split, vsplit --next-to . search_syntax . . ( ) . --type tab . --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 . --allow-remote-control [=no] kitty ( kitty.conf ). . ( SSH) . --remote-control-password . --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-source [=none] 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-add-formatting [=no] --stdin-source (formatting escape codes) . --stdin-add-line-wrap-markers [=no] --stdin-source (carriage return) ( ) . . --marker (marker) . toggle_marker ( /marks ). --os-window-class WM_CLASS X11 (application id) Wayland --type. kitty . --os-window-name WM_NAME X11 --type. --os-window-class . --os-window-title . . current --source-window . --os-window-state [=normal] . : normal, fullscreen, maximized, minimized --os-window-position 10x20. / . . --logo PNG () . window_logo_path . . --logo-position . --logo . window_logo_position . --logo-alpha [=-1] . --logo . window_logo_alpha . --color . .conf kitty.conf :: --color background=white --color foreground=red --spacing (margin padding) . : margin=20 padding-left=10 margin-h=30. *-h *-v . . (overlay) . --watcher, -w . . (watchers) launch . . watcher kitty.conf . --os-panel . panel --override --config. . :: launch --type os-panel --os-panel lines=2 --os-panel edge=bottom sh -c "echo; echo; echo hello; sleep 5s" --hold-after-ssh [=no] --cwd=current ssh kitten . --help, -h [=no] (GLOBAL OPTIONS) --to . --listen-on listen_on kitty.conf . KITTY_LISTEN_ON . . --password . kitty.conf . --use-password always . --password-file [=rc-pass] . . . - STDIN . fd:num num . --password . rc-pass . --password-env [=KITTY_RC_PASSWORD] . --password-file . KITTY_RC_PASSWORD . --use-password [=if-available] . (always) (never) . always . : if-available, always, never 0.48.2 July 30, 2026 kitten-@-launch(1)