gsty

Ghostty live preview theme browser and installer TUI.

Browse, preview, and apply Ghostty terminal themes from a live TUI. Supports filtering by dark/light mode, searching by name, and real-time palette preview with a Rust code snippet.

Usage

gsty                          # interactive TUI theme picker
gsty --list                   # plain text listing (non-TTY fallback)

Theme Discovery

gsty searches these paths for Ghostty theme files:

/Applications/Ghostty.app/Contents/Resources/ghostty/themes
/opt/homebrew/share/ghostty/themes
/usr/share/ghostty/themes
~/.config/ghostty/themes

Selected themes are applied to ~/.config/ghostty/auto/theme.ghostty. Reload Ghostty with Shift+Cmd+, to see the change.

Installation

gsty is available on crates.io and Homebrew.

Cargo

cargo install gsty

Homebrew

brew install tappunk/gsty/gsty

Homebrew package support is Apple Silicon only.

Build from Source

git clone https://github.com/tappunk/gsty.git
cd gsty
cargo build --release
sudo cp target/release/gsty /usr/local/bin/gsty

Local Verification

Run the local verification gate before releases:

cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all-targets

Releasing

Use the release pipeline to cut a GitHub release, publish to crates.io, and update the Homebrew tap:

./release.sh --dry-run
./release.sh patch