Implement an option to control the installation of the kitty bootstrap script

kittens/ssh/main.py

@@ -156,6 +156,8 @@ def make_tarfile(ssh_opts: SSHOptions, base_env: Dict[str, str], compression: st
         env['KITTY_LOGIN_SHELL'] = ssh_opts.login_shell
     if ssh_opts.cwd:
         env['KITTY_LOGIN_CWD'] = ssh_opts.cwd
+    if ssh_opts.remote_kitty != 'no':
+        env['KITTY_REMOTE'] = ssh_opts.remote_kitty
     env_script = serialize_env(env, base_env)
     buf = io.BytesIO()
     with tarfile.open(mode=f'w:{compression}', fileobj=buf, encoding='utf-8') as tf:
@@ -171,9 +173,10 @@ def make_tarfile(ssh_opts: SSHOptions, base_env: Dict[str, str], compression: st
                 f'{arcname}/ssh/*',          # bootstrap files are sent as command line args
                 f'{arcname}/zsh/kitty.zsh',  # present for legacy compat not needed by ssh kitten
             ))
-        arcname = 'home/' + rd + '/kitty'
-        add_data_as_file(tf, arcname + '/version', str_version.encode('ascii'))
-        tf.add(shell_integration_dir + '/ssh/kitty', arcname=arcname + '/bin/kitty', filter=normalize_tarinfo)
+        if ssh_opts.remote_kitty != 'no':
+            arcname = 'home/' + rd + '/kitty'
+            add_data_as_file(tf, arcname + '/version', str_version.encode('ascii'))
+            tf.add(shell_integration_dir + '/ssh/kitty', arcname=arcname + '/bin/kitty', filter=normalize_tarinfo)
         tf.add(f'{terminfo_dir}/kitty.terminfo', arcname='home/.terminfo/kitty.terminfo', filter=normalize_tarinfo)
         tf.add(glob.glob(f'{terminfo_dir}/*/xterm-kitty')[0], arcname='home/.terminfo/x/xterm-kitty', filter=normalize_tarinfo)
     return buf.getvalue()

kittens/ssh/options/definition.py

@@ -102,6 +102,19 @@ The working directory on the remote host to change to. Env vars in this
 value are expanded. The default is empty so no changing is done, which
 usually means the home directory is used.
 ''')
+
+opt('remote_kitty', 'if-needed', choices=('if-needed', 'no', 'yes'), long_text='''
+Make kitty available on the remote server. Useful to run kittens such as the
+icat kitten to display images or the transfer file kitten to transfer files.
+Only works if the remote server has an architecture for which pre-compiled
+kitty binaries are available. Note that kitty is not actually copied to the
+remote server, instead a small bootstrap script is copied which will download
+and run kitty when kitty is first executed on the remote server. A value of
+:code:`needed` means kitty is installed only if not already present in the
+system-wide PATH. A value of :code:`yes` means that kitty is installed even if
+already present, and the installed kitty takes precedence. Finally, :code:`no`
+means no kitty is installed on the remote machine.
+''')
 egr()  # }}}
 
 agr('ssh', 'SSH configuration')  # {{{

kittens/ssh/options/parse.py

@@ -38,6 +38,14 @@ class Parser:
     def remote_dir(self, val: str, ans: typing.Dict[str, typing.Any]) -> None:
         ans['remote_dir'] = relative_dir(val)
 
+    def remote_kitty(self, val: str, ans: typing.Dict[str, typing.Any]) -> None:
+        val = val.lower()
+        if val not in self.choices_for_remote_kitty:
+            raise ValueError(f"The value {val} is not a valid choice for remote_kitty")
+        ans["remote_kitty"] = val
+
+    choices_for_remote_kitty = frozenset(('if-needed', 'no', 'yes'))
+
     def share_connections(self, val: str, ans: typing.Dict[str, typing.Any]) -> None:
         ans['share_connections'] = to_bool(val)
 

kittens/ssh/options/types.py

@@ -5,8 +5,10 @@ import kittens.ssh.copy
 
 if typing.TYPE_CHECKING:
     choices_for_askpass = typing.Literal['unless-set', 'ssh', 'native']
+    choices_for_remote_kitty = typing.Literal['if-needed', 'no', 'yes']
 else:
     choices_for_askpass = str
+    choices_for_remote_kitty = str
 
 option_names = (  # {{{
  'askpass',
@@ -17,6 +19,7 @@ option_names = (  # {{{
  'interpreter',
  'login_shell',
  'remote_dir',
+ 'remote_kitty',
  'share_connections',
  'shell_integration')  # }}}
 
@@ -28,6 +31,7 @@ class Options:
     interpreter: str = 'sh'
     login_shell: str = ''
     remote_dir: str = '.local/share/kitty-ssh-kitten'
+    remote_kitty: choices_for_remote_kitty = 'if-needed'
     share_connections: bool = True
     shell_integration: str = 'inherited'
     copy: typing.Dict[str, kittens.ssh.copy.CopyInstruction] = {}