kitten-@-run(1)

💅 kitten-@-run(1) · kitten Manual 💅

💖 Name 💖

kitten-@-run — literally runs a program on the computer where kitty is running, then brings the output back to you. Bestie, it's giving remote-control errand runner. 🦋✨

🌸 Usage 🌸

kitten @ run CMD ...

✨ Description ✨

okay so here's the vibe: this runs the program you specify on the computer in which kitty is running. 🖥️ When STDIN is not a TTY, it gets forwarded to the program as its STDIN. STDOUT and STDERR from the program are forwarded right back here to you. The exit status of this invocation will be the exit status of the executed program — no cap, it passes that through. 💅

If you just wanna run a program without waiting for a response, use @ launch --type=background instead. Periodt. 🫶

🎀 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 it to the empty string, and just name will remove the environment variable. 🌱
• --allow-remote-control [=no] — 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 [=no] — Show help for this command. 🙈

🌍 Global options 🌍

• --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. 💅

---

💖 That's the whole page, bestie! kitten-@-run(1) from the kitten manual — version 0.49.2, dated Oct 01, 2026. Byeee! 💖