kitten-@-run - Run a program on the computer in which kitty is running and get the output
Contents
Description
Run the specified program on the computer in which kitty is running. When STDIN is not a TTY it is
forwarded to the program as its STDIN. STDOUT and STDERR from the the program are forwarded here. The
exit status of this invocation will be the exit status of the executed program. If you wish to just run a
program without waiting for a response, use @ launch --type=background instead.
Global Options
--to An address for the kitty instance to control. Corresponds to the address given to the kitty
instance via the --listen-onoptionorthelisten_onsettinginkitty.conf.Ifnotspecified,theenvironmentvariableKITTY_LISTEN_ONischecked.Ifthatisalsonotfound,messagesaresenttothecontrollingterminalforthisprocess,i.e.theywillonlyworkifthisprocessisrunwithinakittywindow.--password
A password to use when contacting kitty. This will cause kitty to ask the user for permission to
perform the specified action, unless the password has been accepted before or is pre-configured in
kitty.conf.Touseablankpasswordspecify--use-passwordasalways.--password-file[=rc-pass]
A file from which to read the password. Trailing whitespace is ignored. Relative paths are
resolved from the kitty configuration directory. Use - to read from STDIN. Use fd:num to read from
the file descriptor num. Used if no --passwordissupplied.Defaultstocheckingfortherc-passfileinthekittyconfigurationdirectory.--password-env[=KITTY_RC_PASSWORD]
The name of an environment variable to read the password from. Used if no --password-fileissupplied.DefaultstocheckingtheenvironmentvariableKITTY_RC_PASSWORD.--use-password[=if-available]
If no password is available, kitty will usually just send the remote control command without a
password. This option can be used to force it to always or never use the supplied password. If set
to always and no password is provided, the blank password is used.
Choices: if-available, always, never
0.39.1 Feb 16, 2025 kitten-@-run(1)
Name
kitten-@-run - Run a program on the computer in which kitty is running and get the output
Options
--env Environment variables to set in the child process. Can be specified multiple times to set
different environment variables. Syntax: name=value. Using name= will set to empty string and just
name will remove the environment variable.
--allow-remote-control
The executed program will have privileges to run remote control commands in kitty.
--remote-control-password
Restrict the actions remote control is allowed to take. This works like remote_control_password.Youcanspecifyapasswordandlistofactionsjustasforremote_control_password.Forexample::
--remote-control-password '"my passphrase" get-* set-colors'
This password will be in effect for this window only. Note that any passwords you have defined for
remote_control_passwordinkitty.confarealsoineffect.Youcanoverridethembyusingthesamepasswordhere.Youcanalsodisableallremote_control_passwordglobalpasswordsforthiswindow,byusing::
--remote-control-password '!'
This option only takes effect if --allow-remote-controlisalsospecified.Canbespecifiedmultipletimestocreatemultiplepasswords.Thisoptionwasaddedtokittyinversion0.26.0--help,-h
Show help for this command
Usage
kitten@runCMD...
