kitten-@-load-config - Man Page

(Re)load a config file


kitten @ load-config CONF_FILE ...


(Re)load the specified kitty.conf config files(s). If no files are specified the previously specified config file is reloaded. Note that the specified paths must exist and be readable by the kitty process on the computer that process is running on. Relative paths are resolved with respect to the kitty config directory on the computer running kitty.



By default, any config overrides previously specified at the kitty invocation command line or a previous load-config-file command are respected. Use this option to have them ignored instead.

--override, ā€‰-o

Override individual configuration options, can be specified multiple times. Syntax: name=value. For example: -o font_size=20


Don't wait for a response indicating the success of the action. Note that using this option means that you will not be notified of failures.

--help, ā€‰-h

Show help for this command

Global options


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.


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.

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

Choices: if-available, always, never

Referenced By


Apr 15, 2024 0.34.0 kitten Manual