kitten-ssh(1) kitty kitten-ssh(1) (NAME) kitten-ssh - (OVERVIEW) o <# shell-integration> o / o o kitten o o kitty 0.25.0: 0.30.0: ssh . . Shell integration <#shell-integration> terminfo kitty . ssh ssh . ssh . : kitten ssh some-hostname-to-connect-to ( ) . (alias) rc : alias s="kitten ssh" s hostname . kitty.conf : map f1 new_window_with_cwd F1 ssh kitten . ssh ~/.config/kitty/ssh.conf . : # copy .zshrc .vimrc .vim # env SOME_VAR=x # COPIED_VAR env COPIED_VAR=_kitty_copy_env_var_ # hostname someserver-* copy env-files env SOMETHING=else hostname someuser@somehost copy --dest=foo/bar some-file copy --glob some/files.* ssh.conf . : kitten ssh --kitten interpreter=python servername --kitten ssh.conf . ssh.conf . SSH hostname . : SSH . . (A real world example) SSH . SSH . ssh kitten zsh vim : # hostname myserver-* # zsh my-conf/zsh env ZDOTDIR=$HOME/my-conf/zsh copy --dest my-conf/zsh/.zshrc .zshrc copy --dest my-conf/zsh/.zshenv .zshenv # zsh # vim my-conf/vim env VIMINIT=$HOME/my-conf/vim/vimrc env VIMRUNTIME=$HOME/my-conf/vim copy --dest my-conf/vim .vim copy --dest my-conf/vim/vimrc .vimrc (How it works) ssh SSH POSIX sh ( ) interpreter . TTY kitty tarball Base64 . (login shell) . kitten TTY . kitty kitten . OpenSSH 8.4 . : BSD . POSIX sh python interpreter ssh.conf . : (escape codes) KITTY_PID <#envvar- KITTY_PID> KITTY_WINDOW_ID <#envvar-KITTY_WINDOW_ID> ( tmux ) ssh kitten . (Host bootstrap configuration) hostname hostname * . (glob pattern) . . user@host . . . include <#include> . 0.28.0 . . interpreter interpreter sh . POSIX python . sh . remote_dir remote_dir .local/share/kitty-ssh-kitten kitten . $HOME . / $HOME . copy . HOME HOME . . . : copy .vimrc .zshrc .config/some-dir --dest : copy --dest some-other-name some-file --glob : copy --glob images/*.png --exclude : copy --glob --exclude *.jpg --exclude *.bmp images/* . copy . (Login shell environment) shell_integration shell_integration inherited . Shell integration <#shell-integration> . inherited kitty.conf . . login_shell . . env . ( env VAR=) . ( env VAR) . _kitty_copy_env_var_ . . : env VAR1=a env VAR2=${HOME}/${VAR1}/b VAR2 /a/b . cwd . . HOME . color_scheme . .conf kitty themes <> . / conf./ . remote_kitty remote_kitty if-needed kitten . icat <> <> . kitten . kitten kitten . if-needed kitten PATH . yes kitten . no kitten . kitten update-self . SSH (Ssh configuration) share_connections share_connections yes kitty . . SSH ControlMasters kitty . close_shared_ssh_connections <#action-close_shared_ssh_connections> . askpass askpass unless-set SSH . askpass kitty SSH_ASKPASS <#envvar-SSH_ASKPASS> . ssh ssh askpass ssh . native askpass kitty . kitty askpass SSH kitten . delegate ssh kitten . (delegate) . delegate ssh ssh kitten kitten . ssh kitten . forward_remote_control forward_remote_control no kitty . kitty . : . SSH ( @mykitty) . SSH KITTY_LISTEN_ON <#envvar-KITTY_LISTEN_ON> . Askpass (Askpass automation) password SSH . "backend:secret" . backend "text" . : password text:my_password backend "text:" . . totp_secret TOTP SSH. "backend:secret" . backend "text" . : totp_secret text:JBSWY3DPEHPK3PXP backend "text:" . totp_digits totp_digits 6 TOTP . 6 . totp_period totp_period 30 TOTP . 30 . copy (The copy command) copy [options] file-or-dir-to-copy ... . HOME HOME . . . (OPTIONS) --glob [=no] (glob patterns). (wildcards) /**/ . : . --dest . HOME . ( HOME HOME ). ~ . --exclude . . . . / . /**/ . **/directory_name . . --symlink-strategy (symlink). . resolve / . keep-path resolve . . : preserve : keep-path, preserve, resolve terminfo (Copying terminfo files manually) ssh kitten . terminfo : infocmp -a xterm-kitty | ssh myserver tic -x -o \~/.terminfo /dev/stdin ( Balabit) macOS tic STDIN tic . embedded tic terminfo ~/.terminfo/x/xterm-kitty . root kitty-terminfo terminfo . OpenSSH ssh . FreeBSD terminfo termcap terminfo ( kitty): infocmp -CrT0 xterm-kitty termcap /usr/share/misc/termcap . ( ) : cap_mkdb /usr/share/misc/termcap (AUTHOR) Kovid Goyal (COPYRIGHT) 2026, Kovid Goyal 0.48.2 July 30, 2026 kitten-ssh(1)