From 77ab43cea0c96cd02d279f19f91303add49b52ae Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 21:47:34 +0530 Subject: [PATCH 1/9] docs(readme): update hero tagline to 'Adding taste to your terminal' --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 39bcc0c..fcbda88 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,9 @@ CleanShot 2026-02-22 at 21 26 28@2x -Boo is a polished Ghostty + Zsh setup for a fast, themeable terminal workflow. +**Boo — Adding taste to your terminal.** + +Boo is a design-first Ghostty + Zsh CLI for a fast, themeable terminal workflow. ## What You Get From 3ce8d7d69327a3bfc127948a1661348dda4f05cf Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 21:50:40 +0530 Subject: [PATCH 2/9] docs(readme): revamp positioning and align theme/docs with current Boo --- README.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index fcbda88..4726a16 100644 --- a/README.md +++ b/README.md @@ -8,12 +8,13 @@ Boo is a design-first Ghostty + Zsh CLI for a fast, themeable terminal workflow. ## What You Get -- Ghostty visual config with theme-tinted dark backgrounds -- Full ANSI `palette 0..255` written on theme apply -- Theme presets: `obsidian`, `lunar`, `crimson`, `abyss`, `fallout` (default: `abyss`) -- Dual prompts: native zsh (default) and optional `oh-my-posh` -- Startup dashboard + splash art controls -- Single CLI (`boo`) for theme/font/opacity/prompt/mode/reload/doctor/upgrade +- A single-file CLI (`bin/boo`) with no build step +- Full Ghostty color control, including ANSI `palette 0..255` +- File-based theme engine (`~/.config/boo/themes/*.theme`) with built-in + custom themes +- Built-in themes: `abyss` (default), `clay`, `crimson`, `fallout`, `lunar`, `moss`, `rust` +- Prompt backends: native zsh (default) + optional `oh-my-posh` +- Splash art system (`boo splash`) and startup dashboard +- Operations built in: `doctor`, `reload`, `upgrade`, `uninstall` ## Requirements @@ -70,6 +71,8 @@ boo reload --unsafe boo theme list boo theme abyss boo crimson # shorthand +boo theme create --name synthwave --accent '#ff3ea5' +boo theme delete synthwave boo preview all boo preview abyss --plain ``` @@ -146,11 +149,13 @@ boo uninstall --yes ## Theme Intent -- `obsidian`: original Boo look with purple accents -- `lunar`: cool blue-gray (no purple accents) -- `crimson`: high-contrast red mode - `abyss`: deep indigo with violet-magenta accents (default) -- `fallout`: RobCo Industries phosphor CRT — warm amber-lime on near-black +- `clay`: warm cream light mode with earthy terracotta 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 ## Font Notes (Important) From 837f8258d498a00c167e86e9883e06f5f4d29f60 Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 21:52:00 +0530 Subject: [PATCH 3/9] docs(readme): make positioning beginner-friendly and feature-first --- README.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 4726a16..249e9d8 100644 --- a/README.md +++ b/README.md @@ -4,17 +4,26 @@ **Boo — Adding taste to your terminal.** -Boo is a design-first Ghostty + Zsh CLI for a fast, themeable terminal workflow. +Boo helps you make your terminal look and feel better in minutes — without manually editing config files. ## What You Get -- A single-file CLI (`bin/boo`) with no build step -- Full Ghostty color control, including ANSI `palette 0..255` -- File-based theme engine (`~/.config/boo/themes/*.theme`) with built-in + custom themes -- Built-in themes: `abyss` (default), `clay`, `crimson`, `fallout`, `lunar`, `moss`, `rust` -- Prompt backends: native zsh (default) + optional `oh-my-posh` -- Splash art system (`boo splash`) and startup dashboard -- Operations built in: `doctor`, `reload`, `upgrade`, `uninstall` +- Beautiful ready-to-use themes (plus easy custom themes) +- Better defaults for Ghostty + Zsh setup +- A clean startup panel and optional splash art +- Simple commands to change font, opacity, theme, prompt, and mode +- Quick troubleshooting with `boo doctor` +- Safe install/upgrade/uninstall flow with backups + +## Great for beginners + +If you're new to terminal setup, Boo gives you a polished setup fast with one command and easy controls: + +```bash +boo theme fallout +boo font jetbrains +boo opacity glass +``` ## Requirements From 618ad667b5d8719830c3980c4dc02fae6037496f Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 21:56:59 +0530 Subject: [PATCH 4/9] docs(readme): simplify install flow for beginners --- README.md | 41 ++++++++++++++++++++--------------------- 1 file changed, 20 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 249e9d8..40bde01 100644 --- a/README.md +++ b/README.md @@ -25,29 +25,34 @@ boo font jetbrains boo opacity glass ``` -## Requirements +## Install (2 minutes) -- macOS (tested) -- [Ghostty](https://ghostty.org/) -- `zsh` -- Nerd Font installed in your system (recommended) -- [oh-my-posh](https://ohmyposh.dev/) (optional) - -## Install +```bash +curl -fsSL https://boo.ansub.co/install.sh | bash +source ~/.zshrc +``` -### One-line install +Open a new Ghostty window, then run: ```bash -curl -fsSL https://boo.ansub.co/install.sh | bash && source ~/.zshrc +boo doctor +boo theme fallout ``` -Then apply config now with either: -- press `Cmd+Shift+,` in Ghostty, or -- run `boo reload --unsafe` +## If changes don't apply immediately -If needed, open a new Ghostty window. +- Press `Cmd+Shift+,` in Ghostty, or +- Run `boo reload --unsafe` -### Install from source +## Requirements + +- macOS (tested) +- [Ghostty](https://ghostty.org/) +- `zsh` +- Nerd Font installed in your system (recommended) +- [oh-my-posh](https://ohmyposh.dev/) (optional) + +## Install from source (advanced) ```bash git clone https://github.com/Ansub/boo.git @@ -55,12 +60,6 @@ cd boo ./scripts/install.sh && source ~/.zshrc ``` -Then apply config now with either: -- press `Cmd+Shift+,` in Ghostty, or -- run `boo reload --unsafe` - -If needed, open a new Ghostty window. - ## First 5 Minutes ```bash From 05a0637280dacfc7e6ffaac82ff8488f3d60678d Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 22:02:01 +0530 Subject: [PATCH 5/9] docs(readme): simplify install heading and highlight theme creation --- README.md | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 40bde01..eb8f002 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,11 @@ Boo helps you make your terminal look and feel better in minutes — without man ## What You Get -- Beautiful ready-to-use themes (plus easy custom themes) +- Beautiful ready-to-use themes (plus easy custom theme creation) - Better defaults for Ghostty + Zsh setup - A clean startup panel and optional splash art - Simple commands to change font, opacity, theme, prompt, and mode +- Create your own theme in seconds with `boo theme create` - Quick troubleshooting with `boo doctor` - Safe install/upgrade/uninstall flow with backups @@ -25,7 +26,7 @@ boo font jetbrains boo opacity glass ``` -## Install (2 minutes) +## Install ```bash curl -fsSL https://boo.ansub.co/install.sh | bash @@ -52,14 +53,6 @@ boo theme fallout - Nerd Font installed in your system (recommended) - [oh-my-posh](https://ohmyposh.dev/) (optional) -## Install from source (advanced) - -```bash -git clone https://github.com/Ansub/boo.git -cd boo -./scripts/install.sh && source ~/.zshrc -``` - ## First 5 Minutes ```bash From 2ab76ae81a7c93f02bb5d5716a44fb4828fa1a88 Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 22:03:37 +0530 Subject: [PATCH 6/9] docs(readme): remove font docs and add roadmap note --- README.md | 44 +++++--------------------------------------- 1 file changed, 5 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index eb8f002..69a86a5 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ Boo helps you make your terminal look and feel better in minutes — without man - Beautiful ready-to-use themes (plus easy custom theme creation) - Better defaults for Ghostty + Zsh setup - A clean startup panel and optional splash art -- Simple commands to change font, opacity, theme, prompt, and mode +- Simple commands to change opacity, theme, prompt, and mode - Create your own theme in seconds with `boo theme create` - Quick troubleshooting with `boo doctor` - Safe install/upgrade/uninstall flow with backups @@ -22,7 +22,6 @@ If you're new to terminal setup, Boo gives you a polished setup fast with one co ```bash boo theme fallout -boo font jetbrains boo opacity glass ``` @@ -50,7 +49,6 @@ boo theme fallout - macOS (tested) - [Ghostty](https://ghostty.org/) - `zsh` -- Nerd Font installed in your system (recommended) - [oh-my-posh](https://ohmyposh.dev/) (optional) ## First 5 Minutes @@ -59,7 +57,6 @@ boo theme fallout boo doctor boo status boo theme fallout -boo font jetbrains boo opacity glass boo reload --unsafe ``` @@ -96,16 +93,6 @@ pal_15=#ffe8cc Then run `boo theme `. -### Fonts - -```bash -boo font -boo font list -boo font hack -boo font family "JetBrainsMono Nerd Font" -boo font size 15 -``` - ### Prompt ```bash @@ -158,37 +145,16 @@ boo uninstall --yes - `moss`: damp forest floor — muted earthy green - `rust`: oxidized metal — brutalist copper -## Font Notes (Important) - -If a font family is set but not installed, Ghostty falls back to another font. - -Check what is configured: - -```bash -boo font -ghostty +show-config | rg '^font-family =|^font-size =' -``` - -Check what Ghostty is actually rendering: - -```bash -ghostty +show-face --cp=0x41 -``` - -Install missing Nerd Fonts with Homebrew casks, for example: - -```bash -brew install --cask font-hack-nerd-font -brew install --cask font-jetbrains-mono-nerd-font -brew install --cask font-fira-code-nerd-font -``` +## Roadmap +- Font controls (`boo font`) are planned and will return in an upcoming release. +- More quality-of-life improvements for first-time setup. ## Reload Behavior - `boo reload`: safe guidance only (no key injection, no window/session changes) - `boo reload --unsafe`: tries to trigger Ghostty `reload_config` via detected comma-based keybind (`Cmd+Shift+,` or `Cmd+,`) - Theme changes auto-run safe reload -- Font and opacity changes auto-run unsafe reload +- Opacity changes auto-run unsafe reload - On macOS, `background-opacity` can still require a full Ghostty restart ## State and Paths From a5ccb5876bc6b061675939b93ce770d705f021c1 Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 22:05:50 +0530 Subject: [PATCH 7/9] docs(readme): remove internal state and repo layout sections --- README.md | 32 -------------------------------- 1 file changed, 32 deletions(-) diff --git a/README.md b/README.md index 69a86a5..c300e4c 100644 --- a/README.md +++ b/README.md @@ -157,42 +157,10 @@ boo uninstall --yes - Opacity changes auto-run unsafe reload - On macOS, `background-opacity` can still require a full Ghostty restart -## State and Paths - -Boo persists state in: - -- `~/.config/boo/mode.zsh` -- `~/.config/boo/theme` -- `~/.config/boo/theme.zsh` -- `~/.config/boo/themes/*.theme` -- `~/.config/boo/prompt` -- `~/.config/boo/splash.zsh` -- `~/.config/boo/custom-splash.txt` (when using custom splash) - -Ghostty config targets used by Boo: - -- `~/.config/ghostty/config` -- `~/Library/Application Support/com.mitchellh.ghostty/config` - -## Repo Layout - -- `bin/boo` - Boo CLI -- `shell/boo.zsh` - shell integration + startup panel -- `configs/ghostty/config` - base Ghostty config -- `configs/ohmyposh/boo.omp.json` - active prompt template -- `configs/ohmyposh/presets/*.omp.json` - prompt presets -- `art/*.txt` - built-in splash art -- `themes/*.theme` - built-in theme definitions -- `scripts/install.sh` - local installer -- `install.sh` - bootstrap installer entrypoint - ## Notes - Installer creates timestamped backups when replacing files. - `boo uninstall` restores your original Ghostty config when available, otherwise removes Boo-managed config. -- If your `.zshrc` is complex, keep your existing setup and only source `~/.config/boo/boo.zsh`. -- Helper commands: `boo-mode` -> `boo mode`, `boo-prompt` -> `boo prompt`. -- To skip auto-apply in scripts, set `BOO_NO_AUTO_APPLY=1`. ## License From 54bcd48019402bcbb18f97a6bf4a41dee3188e69 Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 22:10:16 +0530 Subject: [PATCH 8/9] docs(readme): add plain-language command explanations --- README.md | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index c300e4c..d50537b 100644 --- a/README.md +++ b/README.md @@ -63,19 +63,26 @@ boo reload --unsafe ## Common Commands -### Themes +### Themes (change your terminal colors) +Switch themes, preview them, and manage your custom themes. ```bash boo theme list boo theme abyss boo crimson # shorthand -boo theme create --name synthwave --accent '#ff3ea5' -boo theme delete synthwave boo preview all boo preview abyss --plain ``` -Create a custom theme by adding a file in `~/.config/boo/themes/.theme`: +### Create themes (make your own look) +Generate a new theme from an accent color, or create one manually. + +```bash +boo theme create --name synthwave --accent '#ff3ea5' +boo theme delete synthwave +``` + +You can also create a theme file directly in `~/.config/boo/themes/.theme`: ```ini description=my custom theme @@ -93,7 +100,8 @@ pal_15=#ffe8cc Then run `boo theme `. -### Prompt +### Prompt (how your shell prompt looks) +Choose between Boo's built-in prompt and oh-my-posh. ```bash boo prompt @@ -101,14 +109,16 @@ boo prompt set native boo prompt set omp ``` -### Privacy mode +### Mode (what info is shown on startup) +Control how much detail Boo shows when terminal opens. ```bash boo mode full boo mode public ``` -### Splash art +### Splash art (startup visual) +Pick the startup art, use your own, or disable it. ```bash boo splash list @@ -118,7 +128,8 @@ boo splash none boo splash reset ``` -### Reload + diagnostics +### Reload + doctor (apply and troubleshoot) +Reload terminal config and run health checks when something feels off. ```bash boo reload @@ -127,7 +138,7 @@ boo doctor boo doctor fix ``` -### Uninstall +### Uninstall (remove Boo cleanly) ```bash boo uninstall From 3cec799e0d60810aac5563e7a2a3f959b8b90b92 Mon Sep 17 00:00:00 2001 From: Ansub Date: Wed, 25 Feb 2026 22:13:32 +0530 Subject: [PATCH 9/9] docs(readme): include iterative theme creation mode --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index d50537b..fb6877c 100644 --- a/README.md +++ b/README.md @@ -78,7 +78,12 @@ boo preview abyss --plain Generate a new theme from an accent color, or create one manually. ```bash +# Direct mode (one command) boo theme create --name synthwave --accent '#ff3ea5' + +# Iterative mode (guided prompts) +boo theme create + boo theme delete synthwave ```