ghostty-config

Edit Ghostty terminal configuration files with case-sensitive keys and include directives.

155|25|Updated Apr 27, 2025
One-click install
npx skills add https://github.com/sammcj/agentic-coding --skill ghostty-config-sammcj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghostty-config
Source: https://github.com/sammcj/agentic-coding/tree/main/Claude/skills/ghostty-config
Command: npx skills add https://github.com/sammcj/agentic-coding --skill ghostty-config-sammcj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates confusion and errors when configuring the Ghostty terminal emulator, providing comprehensive guidance for all settings and keybindings.

Core Features & Use Cases

  • Complete Configuration Reference: Detailed documentation for all Ghostty options, keybindings, and platform-specific features.
  • Shell Integration Setup: Automatic and manual configuration for bash, zsh, fish, and elvish shells.
  • Use Case: Imagine you want to set up a drop-down quick terminal with custom keybindings. Use this Skill to configure the quick terminal position, size, and global hotkeys.

Quick Start

Use the ghostty-config skill to show me the current effective configuration and help me modify the font settings.

Frequently Asked Questions about ghostty-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Ghostty terminal keybindings and fonts?

Ghostty configuration uses a text-based config file with key=value pairs. Edit your platform-specific config file (macOS: ~/.config/ghostty/config, Linux: $XDG_CONFIG_HOME/ghostty/config) to set fonts, colors, and keybindings. Changes take effect on restart or via CLI reload.

Can I set up shell integration with Ghostty across bash, zsh, and fish?

Ghostty supports automatic and manual shell integration for bash, zsh, fish, and elvish. Configure integration in your Ghostty config file, then source the appropriate shell script in your shell profile for features like prompt rendering and command tracking.

What's the correct syntax for Ghostty configuration files?

Ghostty config uses case-sensitive keys with flexible whitespace around equals signs. Empty values reset options to defaults. Use include directives to load additional configs; CLI options override file settings, and end-of-file include semantics apply for layered configuration.

How do I create a drop-down terminal with custom hotkeys in Ghostty?

Configure window position, size, and decoration settings in your Ghostty config file, then bind a global keybinding to toggle the window. Set quick-terminal-position and related display options, then use keybindings to trigger the drop-down behavior.

Does Ghostty configuration work across macOS, Linux, and Windows?

Ghostty config is cross-platform but respects platform-specific paths: macOS uses ~/.config/ghostty/config with precedence rules, Linux follows XDG standards. Configuration options for fonts, colors, and keybindings work consistently across platforms with platform-aware CLI interactions.

What happens when Ghostty config settings conflict or are empty?

Empty configuration values reset options to their defaults. CLI-driven configuration overrides file settings. Include directives follow end-of-file override semantics, so later includes or CLI flags take precedence over earlier file definitions.