v2.4.0Three layouts: Atelier, Palette, Guided →

Configure Ghostty without leaving it.

Themes, fonts, shortcuts and every everyday setting of Ghostty, in a full-screen interface inside the terminal. A single binary, installed with one command.

$curl -fsSL https://ghostty-config.vitruves.workers.dev/install.sh | sh

or pip install ghostty-config

macOS & Linux, Intel & ARM Checksum-verified, no dependencies MIT licence
The wall of themes: families in a sidebar, each theme a card with its contrast grade
1071themes, contrast-checked
70fonts, one Enter to install
3layouts, same settings
1binary, zero dependencies
Built with Go

The power of Go. None of the Python baggage.

Many Ghostty helpers are Python packages: an interpreter, a virtual environment, dependencies to resolve, a pause at every launch. ghostty-config is written in Go and compiled to one native binary. It opens instantly, redraws the whole screen as images without a stutter, and needs nothing else on your machine.

  • Instant startNative code, no interpreter to boot.
  • One static fileNo runtime, no venv, nothing to break on upgrade.
  • Fast and lightCompiled, concurrent, small memory footprint.
Layouts

Three ways in. The same settings underneath.

Browse, search, or be guided. A chooser asks at first launch; switch any time with F4.

Atelier: the Window section, with opacity, blur and padding beside a live preview
Palette: a search for 'warm dark' lists matching themes, each drawn in its own colours
Guided: step 3 of 6, 'See through the window?', with solid, translucent and frosted glass choices and a preview
First launch

Pick the one that suits you.

The first time it runs, and after an update that brings something new, ghostty-config shows its three layouts side by side. Nothing is locked in: Tool → Interface → Layout changes it later.

Everything can be clicked too: sections, pills, switches, sliders. A double click on a theme card applies it.

The layout chooser: Atelier, Palette and Guided side by side
Features

Everything you'd edit by hand, with a preview.

Browsing changes nothing. A theme or a font is written when you press Enter on it, a setting when you change its value.

Fonts

A specimen set in the font itself

Family, style and size, spacing, ligatures, the OpenType features and variable axes the font really has. 70 monospace families download in one Enter; a missing or proportional font gets a suggestion.

The font list with a specimen of Hack and popular fonts to download
Themes

Make your own

Every colour slot with its contrast ratio, edited by hue, saturation and lightness while the terminal behind changes.

The theme editor: colour slots with hex values and contrast grades
Input

Cursor, clipboard, mouse, every shortcut

Press the new shortcut; conflicts are shown before anything is written.

The Input section: cursor style, blink, clipboard settings
Palette

Each setting opens in place

Search "padding", change it right there, and see the line it will write in your config.

Palette: the padding settings, one opened with its explanation and the line it will write
Guided

Plain questions

Light or dark? Which typeface? Big previews, no jargon.

Guided step 2: Which typeface?
Help

Every key and command, one keystroke away

F1 lists them all; F3 opens Ghostty's own documentation for the highlighted line.

The help overlay listing keys and commands
Good to know

Your config stays yours.

ghostty-config edits the file you already have, line by line, and checks every write.

Your files, kept

Each setting is rewritten on its own line; comments stay. Edits made elsewhere meanwhile are kept too.

Backed up

Every file is copied to ~/.config/ghostty-config/backups/ before its first change. Ctrl+Z undoes the last one.

Validated

After each write the config goes through ghostty +validate-config; any problem is shown with its line.

Live reload

Ghostty reloads after each change: AppleScript on macOS, D-Bus reload-config on Linux.

Drawn with care

In Ghostty and Kitty the interface is drawn as images; elsewhere, and in tmux, with plain text.

Quiet on the network

An hourly check for a new release at most, and the downloads you ask for. Nothing else.

Keys

A handful of keys.

The keys of Atelier; Palette and Guided show theirs in the footer.

TabNext section
↑↓Move through the list
←→Change the highlighted setting
EnterApply, or open all values
DeleteBack to Ghostty's default
⌃ZUndo the last change
/Search themes, settings, commands
⌃T⌃FTry a theme here; star it
F3Ghostty's docs for the line
F4Layout, look, reload, updates
F1Help
EscGo back, then quit
Install

One command. Then ghostty-config.

The script puts a checksum-verified binary for your system in ~/.local/bin. No Go, no git, no dependencies. Prefer a package manager? pip install ghostty-config installs the same binary. Works with Ghostty 1.3 and 1.4.

# install
$ curl -fsSL https://ghostty-config.vitruves.workers.dev/install.sh | sh

# or with pip (pipx and uv work too)
$ pip install ghostty-config

# run
$ ghostty-config

# or from source
$ git clone https://github.com/vitruves/ghostty-config.git
$ cd ghostty-config && make build && make local-install
-config file     edit this file, not the default
-themes dir      user themes directory
-cells           draw with terminal text
-no-images       never draw images
-plain           only characters every terminal has
-no-reload       never ask Ghostty to reload
-no-update-check never check GitHub for releases
-paths           print the files read and written
-version         print the version

Make Ghostty yours in a minute.

1071 themes, 70 fonts, every setting. Nothing written until you say so.

$curl -fsSL https://ghostty-config.vitruves.workers.dev/install.sh | sh

Or pip install ghostty-config · star it on GitHub to follow new releases.