_{Designed by Supafast}

Boo

Boo helps you make Ghostty + Zsh look good in minutes without hand-editing config files.

Start Here (2 to 5 minutes)

Copy and run these commands in order:

curl -fsSL https://boo.ansub.co/install.sh | bash
source ~/.zshrc
boo doctor
boo theme fallout
boo opacity glass

Expected result:

• boo doctor runs checks and tells you if anything needs fixing.
• boo theme fallout changes your color theme.
• boo opacity glass updates background transparency.

If theme or opacity does not change right away, jump to If Something Looks Wrong.

What You Get

• Ready-to-use themes and easy custom theme creation
• Better Ghostty + Zsh defaults
• Startup panel plus optional splash art
• Simple commands for theme, opacity, prompt, and mode
• Built-in troubleshooting with boo doctor
• Safe install/upgrade/uninstall flow with backups

Prerequisites

• macOS or Linux
• Ghostty
• bash, zsh, curl, and tar
• oh-my-posh (optional, only needed for boo prompt set omp)

Install

curl -fsSL https://boo.ansub.co/install.sh | bash
source ~/.zshrc

Linux setup

Install Ghostty for your distribution and Zsh first, then use the same install command above. Run source ~/.zshrc from Zsh, not Bash. If your default shell is Bash, run zsh first; to make Zsh permanent, use chsh -s "$(command -v zsh)" and log in again.

• Ghostty config is written to ${XDG_CONFIG_HOME:-$HOME/.config}/ghostty/config.
• Boo's own files remain in ~/.config/boo, with the CLI in ~/.local/bin.
• The startup panel shows Linux CPU, memory, model, and load information.
• Reload with Ctrl+Shift+, (default binding), or Ghostty's Reload Configuration menu action if you customized your keys. On Linux, boo reload --unsafe shows these instructions without injecting keystrokes.
• Transparency and blur depend on your desktop compositor. See Ghostty's blur support.
• Install a Nerd Font for prompt icons, or keep your existing font. The installer preserves your font, font size, and opacity settings.

Safety notes:

• Installer creates timestamped backups before replacing files.
• boo uninstall can restore your previous Ghostty config when a backup exists.

Verify It Worked

boo doctor
boo status

Expected result:

• boo doctor shows mostly successful checks, or tells you exactly what to run next.
• boo status shows your current theme, mode, splash, prompt, and opacity.

First Customization (3 commands)

boo theme fallout
boo opacity glass
boo prompt set native

If Something Looks Wrong

boo: command not found

source ~/.zshrc

Then open a new Ghostty window and run:

boo doctor

Theme or opacity did not apply

• Press Cmd+Shift+, on macOS or Ctrl+Shift+, on Linux in Ghostty.
• On macOS, you can also run boo reload --unsafe.
• If opacity still does not change on macOS, fully restart Ghostty.

boo doctor reports issues

boo doctor fix
boo doctor

Common Tasks

Themes

boo theme list
boo theme select
boo theme abyss
boo crimson

Use the interactive selector for the easiest flow:

boo theme select

• Shows all themes in a searchable list
• Ordered as: built-in dark, built-in light, community dark, community light
• Live terminal-style preview panel on the right
• Press Enter to apply, Esc to cancel

Community themes are supported too:

• Built-in community themes are auto-discovered from themes/community/
• Installer copies them to ~/.config/boo/themes/community/
• You can add your own by dropping *.theme files into ~/.config/boo/themes/community/

Create your own theme

# One command
boo theme create --name synthwave --accent '#ff3ea5'

# Guided prompts
boo theme create

# Delete a custom theme
boo theme delete synthwave

You can also create ~/.config/boo/themes/<name>.theme manually, then run:

boo theme <name>

Prompt backend

boo prompt
boo prompt set native
boo prompt set omp

Startup mode

boo mode full
boo mode public

Splash art

boo splash list
boo splash saturn
boo splash custom ~/my-art.txt
boo splash none
boo splash reset

Built-in splash options are auto-discovered from ~/.config/boo/art/*.txt.

Health + reload

boo doctor
boo doctor fix
boo reload
boo reload --unsafe

Uninstall / Restore

boo uninstall
# non-interactive
boo uninstall --yes

Expected result:

• Boo-managed setup is removed.
• Previous Ghostty config is restored when available.

Theme Intent

• abyss: deep indigo with violet-magenta accents (default)
• clay: warm cream light mode with earthy terracotta accents
• glacier: icy daylight light mode with steel-blue accents
• crimson: high-contrast red mode
• fallout: RobCo phosphor CRT, warm amber-lime on near-black
• lunar: desaturated monochrome noir
• moss: damp forest floor, muted earthy green
• rust: oxidized metal, brutalist copper

Community themes:

• aurora: cool dark teal with cyan accents
• dracula: classic neon purple/green theme
• tokyonight: electric blue storm palette
• gruvbox: warm retro dark palette
• nord: cool arctic blue-gray palette

Advanced Notes

• boo reload: safe guidance only (no key injection, no window/session changes)
• boo reload --unsafe: on macOS, tries to trigger Ghostty reload_config via comma-based keybind (Cmd+Shift+, or Cmd+,)
• Theme changes auto-run safe reload
• Opacity changes auto-run unsafe reload (manual reload guidance on Linux)
• On macOS, background-opacity can still require a full Ghostty restart

Roadmap

• Font controls (boo font) are planned and will return in an upcoming release.
• More quality-of-life improvements for first-time setup.

License

MIT