ghostty-rice 0.2.2

Full visual profile manager for Ghostty terminal — beyond just colors.

🍚 ghostty-rice

Full visual profile manager for Ghostty — beyond just colors.

English • 简体中文

---

Beyond just colors — total visual control for your Ghostty terminal.

One command. Entire visual transformation. Ghostty reloads instantly.

Profile Gallery (click to expand)

Catppuccin Mocha	One Dark Pro	Cyber

Nord	Dracula	Frosted

Gruvbox

Minimal

---

Color themes only change 16 ANSI colors. ghostty-rice manages complete visual profiles — colors, opacity, blur, titlebar, cursor, padding, icons — and switches them with a single command.

rice switch    # Interactive live switch with instant preview + reload

Why ghostty-rice?

Projects like catppuccin/ghostty and iTerm2-Color-Schemes are color palettes. A terminal's look is more than 16 colors:

Other Color Schemes	🍚 ghostty-rice
✅ Foreground & Background	✅ Everything they do, plus:
✅ 16 ANSI Palette Colors	✅ Window Opacity & Blur Effects
❌ Titlebar Style	✅ Titlebar Style (tabs, transparent, hidden)
❌ Cursor Customization	✅ Cursor Shape, Color & Animation
❌ Window Spacing	✅ Window Padding & Spacing
❌ App Icon	✅ App Icon Variant

Install

pipx install ghostty-rice

Other methods

# With pip
pip install ghostty-rice

# From source
git clone https://github.com/jayleonc/ghostty-rice.git
cd ghostty-rice
pip install -e .

Quick Start

# List available profiles
rice list

# Interactive switch (Themes / Appearance / Fonts / Prompt — 4-tab live preview)
rice switch

# Interactive font picker (quality fonts only, +/- to resize live)
rice font

# Interactive zsh prompt picker + one-shot install to ~/.zshrc
rice prompt --install

# Preview without switching
rice preview "Cyber"

# Check setup (validates config, detects invalid theme references)
rice doctor
# Auto-fix issues (terminfo, invalid theme lines, etc.)
rice doctor --fix

# Reset to a known-good profile if config is broken
rice reset "Catppuccin Mocha"

# See current profile
rice current

Built-in Profiles (10)

Profile	Style
Catppuccin Mocha	Late-night café warmth — fully opaque, steady bar cursor, cozy
One Dark Pro	Studio baseline — high-adoption One Dark family, stable contrast
Codex	Graphite focus — Codex-like dark chrome, warm accent, low-glare text
Everforest	Soft woodland dark — muted contrast for long sessions
Cyber	Blade Runner HUD — translucent glass on neon wallpapers, hidden chrome
Minimal	The typewriter — zero decoration, generous margins, Dieter Rams simplicity
Frosted	Morning studio — frosted light mode with deeper ink and near-opaque glass
Nord	Scandinavian clarity — fully opaque cool precision, Arrival-grade calm
Gruvbox	Analog warmth — fully opaque, earth tones, Wes Anderson palette
Dracula	Gothic cinema — fully opaque purple-grey, bold accents, Tim Burton drama

Rice Switch

rice switch opens a bordered, Mason/Lazy-style panel with 4 tabs:

Tab	What it does
1 Themes	Browse 14 dark theme families with live preview and color swatches
2 Appearance	Accent / Background / Foreground colors, Contrast, Translucent glass
3 Fonts	Font family picker + font size adjustment
4 Prompt	Shell prompt presets with sample preview (applied on confirm)

Keyboard flow:

• 1/2/3/4: switch tabs
• j/k or ↑/↓: move selection
• h/l or ←/→ or +/-: adjust values / font size
• /: search in current list tab
• i: apply current selected item immediately
• u: reset to selected theme defaults
• Enter: confirm and apply all
• q: cancel and rollback

Shell Prompt Presets (zsh)

8 built-in prompt presets — from ultra-minimal to two-line with git branch:

Preset	Sample	Style
Zen	❯	Status arrow only
Minimal Arrow	ghostty-rice ›	Repo name + arrow
Lambda	λ ghostty-rice ›	Lambda accent
Dev Compact	(.venv) repo/subdir »	Virtualenv + short path
Starship	~/project main ⏎ ❯	Two-line with git branch
Boxed	┌ ~/project (main) ⏎ └ ❯	Box-drawn frame + git
Deep Path	(.venv) ~/Dev/project ❯	Full path
Context Rich	[.venv] jay@mbp project #	user@host + path

Prompts can be selected inside rice switch (Tab 4) or standalone:

rice prompt --install

First install requires one reload:

source ~/.zshrc

After that, changing preset via rice prompt or rice switch is applied on the next prompt automatically in Ghostty zsh. The bootstrap also sets a subtle default for zsh-autosuggestions (fg=#555555, theme-safe hex) and exports COLORTERM=truecolor.

If you use Oh My Zsh / Starship / Powerlevel10k, keep the rice bootstrap near the end of ~/.zshrc so it takes effect after other prompt initializers.

Custom Profiles

Profile files follow Ghostty's own format — plain key = value, no file extension, filename is the profile name.

1. Create from an existing profile:

rice create "My Theme" --from "Catppuccin Mocha"

2. Or write one from scratch:

Create a file in the rice profiles directory:

~/.config/ghostty/rice/profiles/

theme = Catppuccin Mocha
background-opacity = 0.90
background-blur = macos-glass-regular
macos-titlebar-style = transparent
window-padding-x = 12
window-padding-y = 8
cursor-style = block
cursor-style-blink = true

3. Add metadata (optional) in manifest.toml alongside your profiles:

[profiles."My Theme"]
description = "My custom visual profile"
author = "me"
tags = ["dark", "custom"]

4. Use it:

rice switch    # then pick "My Theme"

Diagnostics & Recovery

rice doctor          # Check everything: installation, config, theme references
rice doctor --fix    # Auto-fix: terminfo, invalid theme lines, etc.
rice reset "Codex"   # One-click recovery to any builtin profile

rice doctor checks Ghostty installation, version, running state, automation permissions, xterm-ghostty terminfo, config directory, profile status, and validates config for invalid theme references.

If your config is broken (e.g. Ghostty shows "theme not found"), rice doctor --fix removes invalid lines, and rice reset switches to a known-good profile.

How It Works

ghostty-rice preserves your base Ghostty config (shell, fonts, keybinds) and only manages the visual profile section. When you switch profiles:

1. Your base config stays untouched
2. The profile section is replaced
3. Ghostty is auto-reloaded (macOS: native AppleScript API, Linux: xdotool)

Platform Support

Platform	Profile switching	Auto-reload
macOS	Full	Native AppleScript API
Linux	Full	Via xdotool (optional)

Call for Themes

We're building a collection of stunning Ghostty visual profiles — and your profile could be next.

If you've crafted a look you love, submit it as a PR:

1. Add your profile file to ghostty_rice/presets/
2. Add metadata in ghostty_rice/presets/manifest.toml
3. (Bonus) Include a screenshot in docs/screenshots/

All contributors are credited in the manifest. See Contributing below for dev setup.

Contributing

Contributions welcome — especially new profiles, platform support, and shader management.

git clone https://github.com/jayleonc/ghostty-rice.git
cd ghostty-rice
uv venv .venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

License

MIT