🔮 Ghostty Config

Enterprise-grade, modular, cross-platform terminal configuration.

---

Philosophy

Principle	Implementation
Single source of truth	Fonts & icons → 10-font.conf · Colors → 20-colors.conf
One file, one responsibility	Numbered modules in conf.d/
Cross-platform by default	Unsupported keys are silently ignored per-platform
Secure defaults	Clipboard guarded, close confirmation, update checks
Zero conflicts with Neovim	Ctrl+Shift+… for Ghostty, Ctrl/Alt+… pass through
Machine-local overrides	99-local.conf (gitignored) — never breaks upstream

Architecture

ghostty-config/
├── README.md
├── LICENSE
├── CHANGELOG.md
├── .gitignore
├── .editorconfig
├── config                          # Entrypoint (orchestrator)
├── conf.d/
│   ├── 00-core.conf
│   ├── 10-font.conf
│   ├── 20-colors.conf
│   ├── 30-keybindings.conf
│   ├── 40-window.conf
│   ├── 50-cursor.conf
│   ├── 60-mouse.conf
│   ├── 70-security.conf
│   ├── 80-performance.conf
│   ├── 85-platform.conf
│   └── 99-local.conf              # GITIGNORED
├── shaders/
│   └── .gitkeep
└── scripts/
    └── install.sh

Quick Start

git clone https://github.com/ca971/ghostty-config.git ~/.config/ghostty
cd ~/.config/ghostty
chmod +x scripts/install.sh
./scripts/install.sh

Requirements

Dependency	Purpose	Install
Ghostty ≥ 1.2	Terminal emulator	See website
JetBrains Mono	Primary font	apt|dnf|pacman or download
Symbols Nerd Font	Icon glyphs	NerdFontsSymbolsOnly.tar.xz

Module Map

File	Domain	Source of Truth
config	Orchestrator	—
00-core.conf	Shell integration, fundamentals	—
10-font.conf	Typography, ligatures, icon mapping	✦ Fonts & Icons
20-colors.conf	Palette, cursor, selection colors	✦ Colors & Highlights
30-keybindings.conf	All keyboard shortcuts	—
40-window.conf	Chrome, padding, opacity, sizing	—
50-cursor.conf	Cursor shape and behavior	—
60-mouse.conf	Mouse behavior, selection	—
70-security.conf	Clipboard, permissions, updates	—
80-performance.conf	Scrollback, shaders	—
85-platform.conf	macOS / Linux / WSL specifics	—
99-local.conf	Machine-local overrides (gitignored)	—

Keybindings Cheatsheet

Click to expand

Action	Binding
Split right	Ctrl+Shift+\
Split down	Ctrl+Shift+-
Navigate split	Ctrl+Shift+H/J/K/L
Resize split	Ctrl+Shift+Alt+H/J/K/L
Zoom split	Ctrl+Shift+Z
Equalize splits	Ctrl+Shift+E
New tab	Ctrl+Shift+T
Close surface	Ctrl+Shift+W
Tab 1–9	Ctrl+Shift+1–9
Quick terminal	`Ctrl+`` (global)
Reload config	Ctrl+Shift+,
Inspector	Ctrl+Shift+I

Diagnostics

ghostty +show-config       # Resolved config (all modules merged)
ghostty +list-themes       # Available built-in themes
ghostty +list-fonts        # Detected system fonts
ghostty +list-keybinds     # Active keybindings
ghostty +list-actions      # All bindable actions

License

MIT