Ghostty Documentation
Official docs for Ghostty — a fast, native, cross-platform terminal emulator written in Zig.
CRITICAL: grep references/ for keywords before answering.
Reference Index (100 docs)
Configuration
references/config/reference.mdx— Complete configuration reference (all options)references/config/index.mdx— Configuration overviewreferences/config/keybind/reference.mdx— Keybinding referencereferences/config/keybind/sequence.mdx— Key sequencesreferences/config/keybind/index.mdx— Keybinding overview
Features
references/features/shell-integration.mdx— Shell integration (bash/zsh/fish)references/features/theme.mdx— Themingreferences/features/applescript.mdx— AppleScript automation
Installation & Release Notes
references/install/binary.mdx— Binary downloadreferences/install/package.mdx— Package managersreferences/install/build.mdx— Build from sourcereferences/install/release-notes/— Release notes (1.0.1 → 1.3.0)
Troubleshooting
references/help/— GTK OpenGL, macOS login shells, tiling WMs, terminfo, synchronized output
Linux
references/linux/systemd.mdx— systemd integration
Virtual Terminal Reference (66 docs)
references/vt/reference.mdx— VT reference overviewreferences/vt/csi/— CSI sequences (cursor movement, editing, scrolling, etc.)references/vt/esc/— ESC sequences (DECSC, DECRC, RIS, etc.)references/vt/osc/— OSC sequences (title, clipboard, hyperlinks, colors)references/vt/dcs/— DCS sequencesreferences/vt/mode/— Terminal modes (DECCKM, DECOM, DECAWM, etc.)