config.yml

You do not have to touch it. The Settings window writes to it whenever you change something. But if you keep dotfiles in version control, editing directly is supported.

Opening it#

Settings → Configuration → Open Configuration… opens the file in your default text editor, the same way Ghostty does it.

Reloading after an edit#

JusTTY does not watch the file. After editing by hand:

File → Reload Configuration, or ⌘⇧,

Reloading also clears any per-tab font zoom and applies the file's font size; see Fonts and Zoom.

What applies immediately, what does not#

Most settings take effect on reload. Window size and starting position are the exception: they apply to new windows only, so open a new window with ⌘N to see them.

Scope#

This file is JusTTY's own. It is not a ghostty.conf, and JusTTY does not read one. The host builds the terminal configuration itself, which is why the behaviors in Fixed Ghostty Behavior are not adjustable here.

Related#

• Settings Reference — what each key corresponds to in the UI
• Architecture — why the host owns configuration