Configuring Ghostty

Treat the installed Ghostty version and its bundled documentation as authoritative because options and platform support can change between releases. Keep Ghostty's defaults unless a setting serves the user's stated goal.

Establish the Target

1. Identify the requested behavior, operating system, and whether the user wants an explanation, a config snippet, a local config change, runtime diagnosis, or an authorized launch.
2. Run command -v ghostty and ghostty +version when Ghostty is available.
3. Use ghostty +help to list CLI helper actions.
4. Inspect ghostty --help and the relevant ghostty +<cli-action> --help before relying on helper-action syntax.
5. If Ghostty is unavailable, use documentation that matches the user's target version and mark generated configuration as unvalidated.

Do not confuse CLI helper actions such as +show-config with keybind actions such as reload_config. Keybind actions cannot generally be invoked as ghostty +<action> commands.

Keep Commands Non-Interactive