https://github.com/samkleespies/ghostcfg
Interactive TUI for editing Ghostty terminal config
https://github.com/samkleespies/ghostcfg
cli config ghostty python terminal textual tui
Last synced: 4 months ago
JSON representation
Interactive TUI for editing Ghostty terminal config
- Host: GitHub
- URL: https://github.com/samkleespies/ghostcfg
- Owner: samkleespies
- License: mit
- Created: 2026-02-13T20:16:05.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-15T23:54:45.000Z (4 months ago)
- Last Synced: 2026-02-19T07:35:34.076Z (4 months ago)
- Topics: cli, config, ghostty, python, terminal, textual, tui
- Language: Python
- Homepage: https://pypi.org/project/ghostcfg/
- Size: 2.95 MB
- Stars: 11
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ghostcfg
A TUI for editing your [Ghostty](https://ghostty.org) config without touching the file by hand.
Browse 200+ options by category, preview themes live with color swatches, and save — ghostcfg hot-reloads your running Ghostty instance automatically.
## Install
```bash
pipx install ghostcfg # recommended
uv tool install ghostcfg # or with uv
pip install ghostcfg # or plain pip
```
On macOS with Homebrew:
```bash
brew install samkleespies/ghostcfg/ghostcfg
```
Or from source:
```bash
git clone https://github.com/samkleespies/ghostcfg.git
cd ghostcfg
pip install -e .
```
Requires Python 3.10+ and [Ghostty](https://ghostty.org) on PATH.
## Usage
```bash
ghostcfg # or: gcfg
```
### Keybindings
| Key | Action |
|-----|--------|
| `Tab` / `Shift+Tab` | Switch tabs |
| `Up` / `Down` | Navigate options |
| `Enter` | Edit / toggle |
| `Ctrl+S` | Save and reload Ghostty |
| `Ctrl+D` | Reset option to default |
| `?` | Help |
| `q` | Quit |
In the theme browser:
| Key | Action |
|-----|--------|
| `Up` / `Down` | Browse (previews live) |
| `Enter` | Confirm theme |
| `Escape` | Revert to original |
| `d` / `l` / `a` | Dark only / light only / all |
## What it does
- Tabbed categories: Font, Colors, Cursor, Window, Background, Input, Shell, Advanced
- Theme browser with inline color swatch preview, search, and dark/light filtering
- Type-aware widgets: toggles for booleans, dropdowns for enums, color pickers, validated number fields
- Saves trigger SIGUSR2 so Ghostty reloads instantly
- Roundtrip-safe: your comments, blank lines, and ordering are preserved
- Platform-aware: only shows options for your OS
ghostcfg finds your config at:
- **macOS:** `~/Library/Application Support/com.mitchellh.ghostty/config`
- **Linux:** `~/.config/ghostty/config`
## License
MIT