docs: update installation instructions and usage examples across multiple documents

Author: fullstackjam

src/docs/faq.md

@@ -16,7 +16,21 @@ Homebrew installs packages. OpenBoot sets up your **entire** environment — pac
 
 If you're happy managing each of those separately, you don't need OpenBoot. If you'd rather do it in 5 minutes instead of an hour, give it a try.
 
-## Is it safe to pipe curl to bash?
+## Should I use Homebrew or the one-line installer?
+
+**Use Homebrew** (`brew install openboot`) if you:
+- Already have Homebrew installed
+- Want cleaner updates (`brew upgrade openboot`)
+- Prefer package managers over `curl | bash`
+
+**Use the one-line installer** if you:
+- Don't have Homebrew yet (it installs Homebrew for you)
+- Want the absolute fastest setup on a fresh Mac
+- Are running in CI/automation environments
+
+Both methods install the exact same binary.
+
+## Is the one-line installer safe?
 
 Fair question. Here's how OpenBoot handles it:
 
@@ -26,10 +40,12 @@ Fair question. Here's how OpenBoot handles it:
 - The binary is downloaded from GitHub Releases with **SHA256 checksum verification**
 - You can inspect the script before running it:
 
-```
+```bash
 curl -fsSL https://openboot.dev/install.sh > install.sh && cat install.sh
 ```
 
+If you prefer, install via Homebrew instead (see above).
+
 ## What if I already have Homebrew?
 
 OpenBoot detects existing Homebrew installs and skips the setup. It also skips already-installed packages — only new ones get installed. Re-running is fast and safe.
@@ -49,11 +65,21 @@ An account (GitHub or Google OAuth) is needed to:
 
 ## How do I update OpenBoot?
 
+**If installed via Homebrew:**
+
+```bash
+brew upgrade openboot
 ```
+
+**If installed via the one-line installer:**
+
+```bash
 openboot update --self
 ```
 
-Or re-run the install script — it downloads the latest binary and replaces the old one. Your configs, snapshots, and auth tokens are unaffected.
+Or re-run the install script — it downloads the latest binary and replaces the old one.
+
+Your configs, snapshots, and auth tokens are unaffected by updates.
 
 ## Where is my data stored?
 

src/docs/personal.md

@@ -10,18 +10,26 @@ New Mac, unboxed to coding in 5 minutes. Here's the typical flow for individual
 
 ## New Mac: Start from Scratch
 
-Open Terminal, one command:
+**Install OpenBoot:**
 
+```bash
+brew tap openbootdotdev/tap && brew install openboot
 ```
-curl -fsSL https://openboot.dev/install.sh | bash
+
+Or use the one-line installer: `curl -fsSL https://openboot.dev/install.sh | bash`
+
+**Run setup:**
+
+```bash
+openboot
 ```
 
 The TUI pops up — pick the packages you want, hit Enter to confirm. After installation, restart your terminal and start coding.
 
 If you already know what you need, use a preset to skip the picker:
 
-```
-curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset developer
+```bash
+openboot --preset developer
 ```
 
 See [Presets](/docs/presets) for what's in each. Not sure which one? Go with `developer`.
@@ -62,10 +70,10 @@ Next time you reinstall or switch machines, one command restores everything.
 
 ## Day-to-Day Maintenance
 
-```
+```bash
 openboot doctor        # check environment health
 openboot update        # update all Homebrew packages
-openboot update --self # update OpenBoot itself
+brew upgrade openboot  # update OpenBoot itself (if installed via Homebrew)
 ```
 
 ## Typical Flow

src/docs/presets.md

@@ -25,9 +25,17 @@ CLI essentials. Fast and lightweight.
 
 **GUI apps:** Warp, Raycast, Maccy, Stats, Rectangle
 
+```bash
+openboot --preset minimal
 ```
+
+<details>
+<summary>Or use the one-line installer</summary>
+
+```bash
 curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset minimal
 ```
+</details>
 
 ## developer
 
@@ -37,9 +45,17 @@ The recommended starting point. Everything you need to start building, nothing y
 - **CLI:** node, go, pnpm, docker, docker-compose, lazydocker, tmux, neovim, httpie, pre-commit
 - **GUI:** VS Code, OrbStack, Chrome, Arc, Postman, Notion, Scroll Reverser, TablePlus, AppCleaner
 
+```bash
+openboot --preset developer
 ```
+
+<details>
+<summary>Or use the one-line installer</summary>
+
+```bash
 curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset developer
 ```
+</details>
 
 ## full
 
@@ -49,9 +65,17 @@ Complete dev environment. Languages, DevOps, databases, AI tools — all of it.
 - **CLI:** python, uv, rustup, deno, bun, cmake, kubectl, helm, k9s, terraform, awscli, sqlite, postgresql, redis, duckdb, ollama, llm, tig, dive
 - **GUI:** Cursor, Firefox, Proxyman, Obsidian, Figma, IINA, Keka, AlDente, ngrok, Shottr, Miniconda
 
+```bash
+openboot --preset full
 ```
+
+<details>
+<summary>Or use the one-line installer</summary>
+
+```bash
 curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset full
 ```
+</details>
 
 ## Customizing During Install
 
@@ -68,14 +92,14 @@ Want `developer` but with `kubectl`? Select `developer`, then toggle `kubectl` o
 
 For scripted installs, use `--silent` to install a preset exactly as defined:
 
-```
-curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset developer --silent
+```bash
+openboot --preset developer --silent
 ```
 
 Preview what would be installed first with `--dry-run`:
 
-```
-curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset developer --dry-run
+```bash
+openboot --preset developer --dry-run
 ```
 
 See [CLI Reference](/docs/cli-reference) for automation details.

src/docs/quick-start.md

@@ -8,30 +8,53 @@ order: 2
 
 Pick the path that fits your situation.
 
-## New Mac? Bootstrap It
+## Installation
+
+### Homebrew (Recommended)
 
-Open Terminal and run:
+If you already have Homebrew installed:
 
+```bash
+brew tap openbootdotdev/tap
+brew install openboot
 ```
+
+Then run `openboot` to start the interactive setup.
+
+### One-Line Installer
+
+If you don't have Homebrew yet, or prefer the all-in-one installer:
+
+```bash
 curl -fsSL https://openboot.dev/install.sh | bash
 ```
 
+This installer will:
+- Install Xcode Command Line Tools (if needed)
+- Install Homebrew (if needed)
+- Download and run OpenBoot
+
+## New Mac? Bootstrap It
+
+After installing OpenBoot using either method above, run:
+
+```bash
+openboot
+```
+
 What happens next:
 
 ```
-✓ Downloaded OpenBoot
-✓ Xcode Command Line Tools ready
-✓ Homebrew ready
 🚀 Launching interactive installer...
 ```
 
 The TUI opens with the `developer` preset pre-selected. Use **arrow keys** to navigate, **Space** to toggle packages, **Enter** to confirm. After installation, restart your terminal or run `source ~/.zshrc`.
 
 Want a different starting point? Use `--preset`:
 
-```
-curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset minimal
-curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset full
+```bash
+openboot --preset minimal
+openboot --preset full
 ```
 
 See [Presets](/docs/presets) for what's included in each.
@@ -40,16 +63,12 @@ See [Presets](/docs/presets) for what's included in each.
 
 Capture your current Mac's dev environment and save it:
 
-```
-curl -fsSL https://openboot.dev/install.sh | bash -s -- snapshot
-```
-
-Or if `openboot` is already installed:
-
-```
+```bash
 openboot snapshot
 ```
 
+(Or if you haven't installed OpenBoot yet, use the one-line installer: `curl -fsSL https://openboot.dev/install.sh | bash -s -- snapshot`)
+
 Snapshot scans your Homebrew packages, macOS preferences, shell config, and git settings. You'll review everything in a TUI editor before uploading or saving locally.
 
 ```
@@ -74,13 +93,20 @@ See [Snapshot](/docs/snapshot) for the full walkthrough.
 If you're setting up a team's standard environment:
 
 1. **Create a config** on the [dashboard](/dashboard) — pick a base preset, add/remove packages, set up custom scripts
-2. **Share the install URL** in your README or onboarding docs:
+2. **Share installation instructions** in your README or onboarding docs:
 
+```bash
+brew tap openbootdotdev/tap && brew install openboot
+openboot --user yourteam/frontend
 ```
+
+Or use the one-line installer as an alternative:
+
+```bash
 curl -fsSL https://openboot.dev/yourteam/frontend/install.sh | bash
 ```
 
-3. **New team members** run one command and get your exact setup
+3. **New team members** run the commands and get your exact setup
 
 See [For Teams](/docs/teams) for the complete workflow.
 

src/docs/teams.md

@@ -46,21 +46,28 @@ In the dashboard, refine the config:
 
 ### 3. Share
 
-Every config gets a one-line install command:
+Every config gets installation instructions. Recommend Homebrew + CLI flag:
 
+```bash
+brew tap openbootdotdev/tap && brew install openboot
+openboot --user yourteam/frontend
 ```
+
+Or provide the one-line installer as an alternative:
+
+```bash
 curl -fsSL https://openboot.dev/yourteam/frontend/install.sh | bash
 ```
 
-Put this in your:
+Put these in your:
 
 - **README.md** — under "Getting Started" or "Development Setup"
 - **Onboarding checklist** — as the first step
 - **Slack / Teams channel** — pinned for easy access
 
 ### 4. New Developer Joins
 
-They open Terminal on their new Mac and run your command. That's it.
+They run the install command. That's it.
 
 OpenBoot handles Homebrew, installs all packages, sets up their shell, clones dotfiles, and applies macOS preferences. They're ready to code in minutes, not hours.
 
@@ -80,6 +87,6 @@ openboot.dev/yourteam/devops
 
 **Preview before installing.** New team members can preview what they'd get:
 
-```
-curl -fsSL https://openboot.dev/yourteam/frontend/install.sh | bash -s -- --dry-run
+```bash
+openboot --user yourteam/frontend --dry-run
 ```

src/docs/what-is-openboot.md

@@ -20,14 +20,24 @@ OpenBoot is an open-source CLI that sets up your entire macOS development enviro
 
 ## How It Works
 
+**Install via Homebrew (recommended):**
+
+```bash
+brew tap openbootdotdev/tap
+brew install openboot
+openboot
 ```
+
+**Or use the one-line installer:**
+
+```bash
 curl -fsSL https://openboot.dev/install.sh | bash
 ```
 
-This one command:
+The installer:
 
-1. Downloads the `openboot` binary
-2. Installs Xcode Command Line Tools and Homebrew (if needed)
+1. Installs Xcode Command Line Tools and Homebrew (if needed)
+2. Downloads the `openboot` binary
 3. Launches an interactive TUI where you pick your packages
 4. Installs everything, configures your shell, and applies macOS preferences