gitwtfhub

wtf is ghostty-config-cli?

ajr-khll/ghostty-config-cli — explained in plain English

Analysis updated 2026-05-18

28TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A fullscreen terminal app for editing your Ghostty terminal emulator config with a live preview of themes, fonts, and colors.

Mindmap

mindmap
  root((ghostty-config-cli))
    What it does
      Edits Ghostty config file
      Shows live preview
      Preserves rest of config
    Tech stack
      TypeScript
      Ink
      execa
    Use cases
      Pick a Ghostty theme
      Adjust font and cursor
      Try changes safely
    Audience
      Developers
      Terminal users
    Features
      Type to filter pickers
      One level undo
      Atomic safe writes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Browse and preview Ghostty themes before applying one to your config.

REASON 2

Adjust font, cursor style, and colors with instant visual feedback.

REASON 3

Edit specific Ghostty settings without risking your existing comments or keybindings.

REASON 4

Try out config changes in dry run mode before saving them to disk.

What's in the stack?

TypeScriptNode.jsInkexecanpm

How it stacks up

ajr-khll/ghostty-config-cliaudemodo/audemodo-responsive-keepalivecahn91/gpt-repo-mcp
Stars282828
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Node.js 18 or higher, Ghostty itself is recommended for full theme and font listing but not required.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

ghostty-config-cli is a fullscreen terminal tool for editing the configuration of Ghostty, a terminal emulator. Instead of hand editing a text config file, you get a paned interface right inside your terminal with a sidebar for navigating settings, an editor for the selected one, and a live preview panel that shows a mock terminal window updating in real time as you change values. The live preview reflects real theme colors pulled straight from Ghostty's own theme files, the standard 16 color palette, and a cursor that matches your chosen style and blink setting. The tool manages a specific set of settings: theme, font family, font size, background and foreground colors, background opacity, and cursor style with blink. Every other line in your config file, including comments and keybindings, is left completely untouched, and writes happen atomically using a temp file and rename so your config is never left half written. Saving is done with a single key press, and there is one level of undo that restores the exact previous file if you change your mind. When picking a theme or font, you get a searchable, type to filter list pulled from Ghostty's own theme and font listing commands, with warnings if a theme is unknown or a font is not installed. The tool still works even if Ghostty itself is not available on your system path, though some features like theme and font listing will be limited. It requires Node.js version 18 or higher and is installed globally through npm. Once installed, running the command launches the interactive editor, though there are also flags to print current values without a terminal interface, or to try edits without actually saving them. The config file location is detected automatically based on your operating system, following Linux and macOS conventions. It is built with TypeScript, the Ink library for terminal interfaces, and execa for running commands, and is released under the MIT license.

Yoink these prompts

Prompt 1
Install ghostty-config-cli globally with npm and launch the interactive editor.
Prompt 2
Explain how ghostty-config-cli keeps my existing Ghostty config comments and keybindings safe while editing.
Prompt 3
Show me how to use the theme and font pickers in ghostty-config-cli to preview changes live.
Prompt 4
Help me set up a development environment for ghostty-config-cli using npm run dev.

Frequently asked questions

wtf is ghostty-config-cli?

A fullscreen terminal app for editing your Ghostty terminal emulator config with a live preview of themes, fonts, and colors.

What language is ghostty-config-cli written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Ink.

What license does ghostty-config-cli use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ghostty-config-cli to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ghostty-config-cli for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.