Ghostty Theme Selector

A native macOS menu-bar companion for browsing, previewing, and applying Ghostty themes.

Install

npx ghostty-theme-selector@latest install

Open Ghostty, then click the palette icon in the macOS menu bar.

The installer builds the native Swift app locally, installs it in ~/Applications, and starts it automatically when you log in. The icon only appears while Ghostty is running.

Use npx, not a regular local npm install, because this package installs a macOS application rather than a JavaScript library.

Features

• Browse every theme included with Ghostty
• Search and filter by appearance or color
• Preview themes live while scrolling
• One click to save and reload config

Requirements

• macOS 14 or newer
• Ghostty installed in /Applications
• Node.js 18 or newer
• Apple Command Line Tools

Install the command-line tools with:

xcode-select --install

Commands

npx ghostty-theme-selector@latest install
npx ghostty-theme-selector@latest open
npx ghostty-theme-selector@latest uninstall

Uninstalling does not remove your Ghostty configuration or themes.

Config and Privacy

Before changing your Ghostty config, the selector creates an atomic backup with the extension .theme-selector-backup.

Everything runs locally. No configuration or theme data is transmitted.

Development

npm test
npm run build
npm run release:check

The project has no third-party JavaScript dependencies. The application itself is built with SwiftUI and AppKit.

License

MIT