Skip to main content
Ghostty provides a powerful command-line interface for managing configurations, listing resources, and performing various operations without launching the terminal emulator.

​
Usage Pattern

CLI commands are invoked using the +<command> syntax: 
ghostty +<command> [options]
For example: 
ghostty +list-fonts
ghostty +show-config --default
ghostty +validate-config --config-file=custom.conf

​
Available Commands

list-fonts

List all available fonts using Ghostty’s font discovery mechanism

list-themes

Preview or list all available themes for Ghostty

list-keybinds

Display all configured or default keybindings

list-actions

List all available keybind actions

show-config

Display the current configuration in valid config file format

validate-config

Validate a Ghostty configuration file

edit-config

Open the configuration file in your default editor

ssh-cache

Manage the SSH terminfo cache for remote host setup

​
Common Options

Most commands support these options:
  • -h, --help - Display help information for the command
  • --version - Display Ghostty version information

​
Exit Codes

CLI commands follow standard Unix conventions:
  • 0 - Success
  • 1 - Error or validation failure
  • Other non-zero values may indicate specific error conditions