Menu
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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Take screenshots, screen recordings, scrolling captures, and OCR text recognition using CleanShot X. Use when user requests screenshots, captures, screen recording, OCR, text extraction, or image annotation.
Development workflow for this repository. Run `make help` to see available targets.
Development workflow for this repository. Run `make help` to see available targets.
Configure and manage AeroSpace tiling window manager for macOS. Use when working with window layouts, tiling configurations, workspace management, monitor assignments, or AeroSpace keybindings. Keywords: aerospace, tiling, workspaces, window manager, i3-like.
Configure and manage Hammerspoon automation, app launching, and window switching. Use when working with ~/.config/hammerspoon config files, adding keybindings, modifying the leader modal, or troubleshooting Hammerspoon functionality. Window management is handled by AeroSpace.
Trigger and monitor GitHub Actions workflows, CI/CD pipelines, and automated builds. Use when running workflows, triggering CI, deploying via GitHub Actions, downloading artifacts, or checking workflow status on github.com
| 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"] |
Terminal emulator configuration and management.
~/.config/ghostty/config~/.config/ghostty/term.tic/Applications/Ghostty.app/Contents/MacOS/ghosttyghostty +validate-config
Validates configuration syntax and reports errors for unknown fields or invalid values.
ghostty +show-config
Displays the effective configuration, including defaults and user overrides.
Common configuration categories:
window-decoration, window-theme, maximize, fullscreenfont-family, font-size, font-stylebackground-opacity, theme, cursor-styleshell-integration, mouse-hide-while-typing, clipboard-writemacos-option-as-alt, macos-non-native-fullscreenkeybind = <key>=<action>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
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
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 paddingshell-integration = "zsh" - enable shell integration for zshtic -x ~/.config/ghostty/term.ticFormat: keybind = <modifier>+<key>=<action>
Modifiers:
cmd / super - command keyctrl - control keyshift - shift keyalt / option - option keyUse unbind to remove default bindings:
keybind = cmd+t=unbind
Run ghostty +validate-config to see specific error messages. Common issues:
ghostty +show-config to verify effective configurationAlready added to ~/.zshenv:
path=(
"/Applications/Ghostty.app/Contents/MacOS"
$path
)
Official docs: https://ghostty.org/docs