ghostty
Configure and manage Ghostty terminal emulator settings. Use when modifying ghostty config, validating configuration, checking window settings, themes, fonts, keybindings, or troubleshooting ghostty startup behavior.
When & Why to Use This Skill
This Claude skill provides a comprehensive interface for managing and optimizing the Ghostty terminal emulator. It enables users to programmatically modify configuration files, validate syntax, customize visual elements like themes and fonts, and troubleshoot startup behaviors, ensuring a seamless and highly personalized command-line environment.
Use Cases
- Automated Environment Setup: Quickly configure Ghostty settings, including shell integration and path setup, when migrating to a new machine or environment.
- Visual and UI Customization: Effortlessly switch between themes, adjust font sizes, and modify window decorations (e.g., transparency, borders) to improve workspace ergonomics.
- Keybinding Management: Define, list, and troubleshoot custom keybindings to create a more efficient workflow tailored to specific developer needs.
- Configuration Debugging: Use automated validation tools to identify syntax errors or invalid values in the config file, preventing terminal crashes and ensuring stability.
| name | ghostty |
|---|---|
| description | Configure and manage Ghostty terminal emulator settings. Use when modifying ghostty config, validating configuration, checking window settings, themes, fonts, keybindings, or troubleshooting ghostty startup behavior. |
| allowed-tools | [Read, Edit, Bash] |
ghostty
Terminal emulator configuration and management.
Config location
- user config:
~/.config/ghostty/config - terminfo:
~/.config/ghostty/term.tic - binary:
/Applications/Ghostty.app/Contents/MacOS/ghostty
Common actions
validate config
ghostty +validate-config
Validates configuration syntax and reports errors for unknown fields or invalid values.
show current config
ghostty +show-config
Displays the effective configuration, including defaults and user overrides.
list available options
Common configuration categories:
- window:
window-decoration,window-theme,maximize,fullscreen - fonts:
font-family,font-size,font-style - appearance:
background-opacity,theme,cursor-style - behavior:
shell-integration,mouse-hide-while-typing,clipboard-write - macos:
macos-option-as-alt,macos-non-native-fullscreen - keybindings:
keybind = <key>=<action>
other useful commands
ghostty +list-fonts # show available fonts
ghostty +list-themes # show available themes
ghostty +list-keybinds # show current keybindings
ghostty +list-actions # show available actions for keybindings
ghostty +edit-config # open config in editor
Config format
Plain text file with key = value syntax. Comments start with #.
# window settings
window-decoration = false
window-theme = "dark"
maximize = true
# fonts and appearance
font-size = 14
theme = "GitHub Dark Colorblind"
cursor-style = "block"
# keybindings
keybind = cmd+v=paste_from_clipboard
keybind = cmd+c=copy_to_clipboard
Common settings
window modes
maximize = true- start window maximized (fills screen, not fullscreen)fullscreen = true- start window in fullscreen modewindow-decoration = false- hide window title barmacos-non-native-fullscreen = "padded-notch"- fullscreen with notch padding
shell integration
shell-integration = "zsh"- enable shell integration for zsh- terminfo must be installed:
tic -x ~/.config/ghostty/term.tic
keybindings
Format: keybind = <modifier>+<key>=<action>
Modifiers:
cmd/super- command keyctrl- control keyshift- shift keyalt/option- option key
Use unbind to remove default bindings:
keybind = cmd+t=unbind
Troubleshooting
config validation fails
Run ghostty +validate-config to see specific error messages. Common issues:
- unknown field names (check spelling, refer to documentation)
- invalid values for enum types
- missing quotes around string values with spaces
changes not taking effect
- restart ghostty completely (not just new window)
- check
ghostty +show-configto verify effective configuration - ensure no typos in config file path
PATH setup
Already added to ~/.zshenv:
path=(
"/Applications/Ghostty.app/Contents/MacOS"
$path
)
Documentation
Official docs: https://ghostty.org/docs