<!-- TOC: Quick Start | THE EXACT PROMPT | Actions | Configuration | Troubleshooting | References -->

Ghostty CLI

Core Capability: Control and configure the Ghostty terminal emulator from the command line.

Quick Start

# CLI location (or symlinked as `ghostty`)
/Applications/Ghostty.app/Contents/MacOS/ghostty

# List available actions
ghostty +list-actions

# Check version
ghostty --version

THE EXACT PROMPT — Window/Tab Management

# New window
ghostty +new-window

# New tab
ghostty +new-tab

# Splits
ghostty +new-split:right
ghostty +new-split:down

# Navigate splits
ghostty +goto-split:up
ghostty +goto-split:down
ghostty +goto-split:left
ghostty +goto-split:right

# Close current surface
ghostty +close-surface

# Toggle fullscreen
ghostty +toggle-fullscreen

THE EXACT PROMPT — Font Management

# Adjust font size
ghostty +increase-font-size:1
ghostty +decrease-font-size:1
ghostty +reset-font-size

# List available fonts
ghostty +list-fonts

THE EXACT PROMPT — Configuration

# Config file: ~/.config/ghostty/config

# Show current config
ghostty +show-config

# Validate config
ghostty +validate-config

# Reload config (live)
ghostty +reload-config

# List themes/keybinds
ghostty +list-themes
ghostty +list-keybinds

Launch Options

# Start with specific config
ghostty --config-file=/path/to/config

# Start with command
ghostty -e "htop"

# Start in directory
ghostty --working-directory=/path/to/dir

Essential Commands

Troubleshooting: Remote SSH

Problem: Seeing [57414u garbage when pressing numpad Enter over SSH.

Quick fix:

infocmp -x xterm-ghostty | ssh user@server 'mkdir -p ~/.terminfo && tic -x -o ~/.terminfo -'

Fallback (no terminfo access):

alias myserver='TERM=xterm-256color ssh user@myserver'

Full guide: [REMOTE-TERMINFO.md](references/REMOTE-TERMINFO.md)

References