kitten-@-run - Run a program on the computer in which kitty is
running and get the output
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.
- --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. You can specify a password and list of actions
just as for remote_control_password. For example::
--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_password
in kitty.conf are also in effect. You can override them by using
the same password here. You can also disable all
remote_control_password global passwords for this window, by
using::
--remote-control-password '!'
This option only takes effect if --allow-remote-control is
also specified. Can be specified multiple times to create multiple
passwords. This option was added to kitty in version 0.26.0
- --help, -h
- Show help for this command
- --to
- An address for the kitty instance to control. Corresponds to the address
given to the kitty instance via the --listen-on option or the
listen_on setting in kitty.conf. If not specified, the
environment variable KITTY_LISTEN_ON is checked. If that is also
not found, messages are sent to the controlling terminal for this process,
i.e. they will only work if this process is run within a kitty
window.
- --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. To use a
blank password specify --use-password as always.
- --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 --password is supplied. Defaults to checking for the
rc-pass file in the kitty configuration directory.
- --password-env
[=KITTY_RC_PASSWORD]
- The name of an environment variable to read the password from. Used if no
--password-file is supplied. Defaults to checking the environment
variable KITTY_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