SpookiUI is a live, terminal-based configurator for the Ghostty terminal that lets you browse and edit every Ghostty option interactively with immediate live reload.

Stars

86

7-day growth

No data

Forks

3

Open issues

0

License

MIT

Last updated

2026-07-26

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It dynamically discovers all ~200 options from your installed Ghostty version (no hardcoded list), requires zero third-party Python dependencies, applies changes live via AppleScript or SIGUSR2, and includes safety features like validation, backups, and rollback. It also offers profiles, a config doctor, one-click SSH fix, and nostalgic animated shaders (treats) for fun.

Who it is for

  • Ghostty terminal users
  • Terminal customization enthusiasts
  • Developers who frequently tweak terminal settings
  • macOS and Linux users seeking a live config editing workflow

Use cases

  • Browsing and live-tuning Ghostty's ~200 configuration options from a TUI
  • Creating and switching between light and dark profile snapshots
  • Using the config doctor to catch invalid, duplicate, or conflicting settings
  • Fixing garbled SSH sessions by adding a TERM alias with one command

Strengths

  • Zero third-party dependencies – single Python script using only standard library
  • Dynamic option discovery via Ghostty's own +show-config, ensuring perfect version alignment
  • Safe editing with Ghostty validation, automatic backups, full session revert, and rollback on invalid values
  • Rich TUI with typed editors (booleans, enums, themes, sliders, keybindings, colors) and live preview

Considerations

  • Live reload requires a running Ghostty instance and on macOS needs Accessibility permission
  • Auto-reload is only implemented for macOS and Linux; on other platforms changes are written but must be reloaded manually
  • Some options (e.g., language) cannot be applied without a full restart, and are flagged as such

README quick start

Installation

Description

A TUI configuration app for the Ghostly terminal for macOS/Linux

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482