docs: align install and update guidance with current CLI

Author: fullstackjam

src/docs/cli-reference.md

@@ -7,7 +7,7 @@ order: 9
 
 # CLI Commands
 
-OpenBoot v1.0 has two real verbs: **`install`** adds things to your Mac, **`snapshot`** captures what's on it. Everything else is auth or bookkeeping.
+OpenBoot's main commands are **`install`**, which adds things to your Mac, and **`snapshot`**, which captures what's on it. Supporting commands handle authentication, diagnostics, and updates.
 
 ```
 openboot install [source] # install from preset, file, or cloud config
@@ -235,19 +235,19 @@ openboot update            # upgrade to the latest release
 openboot update --dry-run  # print what would be done, change nothing
 ```
 
-Both install methods (the one-line installer and `brew install`) put OpenBoot under Homebrew, so `openboot update` simply runs `brew upgrade openboot` for you. Running `brew upgrade openboot` yourself does the same thing.
+Both install methods (the one-line installer and `brew install`) put OpenBoot under Homebrew. On these installs, `openboot update` refreshes the `openbootdotdev/tap` repository and runs `brew upgrade openbootdotdev/tap/openboot`. You can also upgrade with Homebrew directly.
 
 If you installed a release binary by hand instead of through Homebrew, `update` downloads from GitHub and keeps a backup of the previous binary:
 
 ```
-openboot update --version 1.0.0   # pin to an exact version
+openboot update --version 1.0.5   # pin to an exact version
 openboot update --rollback        # restore the most recent backup
 openboot update --list-backups    # list backups under ~/.openboot/backup
 ```
 
 Backups live in `~/.openboot/backup/`; the 5 most recent are kept. `--version` and `--rollback` are refused on Homebrew-managed installs — use `brew` for those.
 
-`install` also does a lightweight auto-update check before it runs. Set `OPENBOOT_DISABLE_AUTOUPDATE=1` to skip it.
+`install` also checks for updates before it runs. By default, it only notifies you when a newer version is available. Automatic upgrades are opt-in: set `"autoupdate": "true"` in `~/.openboot/config.json` to enable them, or `"autoupdate": "false"` to disable checks. Set `OPENBOOT_DISABLE_AUTOUPDATE=1` to skip the check regardless of that preference.
 
 ---
 

src/docs/env-vars.md

@@ -1,13 +1,13 @@
 ---
 title: Environment Variables
-description: All environment variables the install script and openboot CLI understand.
+description: Environment settings for the install script and openboot CLI.
 group: Reference
 order: 12
 ---
 
 # Environment Variables
 
-Every environment variable OpenBoot reads. Short list — v1.0 kept things minimal.
+Environment settings for the install script and CLI.
 
 ## Install script (`install.sh`)
 
@@ -22,7 +22,7 @@ The script always installs the latest release published in the tap; there is no
 Preview the install script without making changes:
 
 ```
-OPENBOOT_DRY_RUN=true curl -fsSL https://openboot.dev/install.sh | bash
+curl -fsSL https://openboot.dev/install.sh | OPENBOOT_DRY_RUN=true bash
 ```
 
 ## CLI (`openboot`)
@@ -35,7 +35,7 @@ Used by the `openboot` binary at runtime.
 | `OPENBOOT_GIT_EMAIL` | Git user email — **read only in `--silent` mode** (required if Git isn't already configured) |
 | `OPENBOOT_PRESET` | Default preset. Overridden by `-p` / `--preset` |
 | `OPENBOOT_USER` | Default cloud config (alias or `user/slug`). Overridden by `-u` / `--user` |
-| `OPENBOOT_DOTFILES` | Dotfiles repo URL to clone and link. Overrides the config's `dotfiles_repo` |
+| `OPENBOOT_DOTFILES` | Dotfiles repo URL for preset-based installs. Remote configs and snapshots use their own dotfiles settings; this does not override a remote config's `dotfiles_repo` |
 | `OPENBOOT_DISABLE_AUTOUPDATE` | Set to `1` to skip the auto-update check that runs before `install` |
 | `OPENBOOT_API_URL` | Override the openboot.dev API base URL — testing only; must be `https://` or `http://localhost` |
 
@@ -63,4 +63,5 @@ Not environment variables, but useful to know.
 | `~/.openboot/snapshot.json` | Local snapshot (when using `--local`) |
 | `~/.openboot/install_state.json` | What was installed on this machine, and when |
 | `~/.openboot/sync_source.json` | The cloud config this machine is synced to |
+| `~/.openboot/config.json` | Update preference: `"autoupdate": "notify"` (default), `"true"` (automatic upgrades), or `"false"` (no checks) |
 | `~/.dotfiles/` | Cloned dotfiles repo (when configured) |

src/docs/faq.md

@@ -95,7 +95,7 @@ An account (GitHub or Google OAuth) is needed to:
 brew upgrade openboot
 ```
 
-`openboot update` does the same thing — on a Homebrew install it just runs `brew upgrade openboot` for you. OpenBoot also does a lightweight auto-update check when you run `install`; set `OPENBOOT_DISABLE_AUTOUPDATE=1` to skip it.
+You can also run `openboot update`. On a Homebrew install, it refreshes the OpenBoot tap before upgrading the formula. When you run `install`, OpenBoot checks for newer releases and notifies you by default; automatic upgrades are opt-in. Set `OPENBOOT_DISABLE_AUTOUPDATE=1` to skip the check. See [CLI Commands — Update](/docs/cli-reference#openboot-update) for update preferences and options for manually installed binaries.
 
 Your configs, snapshots, and auth tokens are unaffected by upgrades.
 

src/docs/quick-start.md

@@ -32,7 +32,7 @@ The interactive TUI opens and you pick what to install.
 openboot install
 ```
 
-The TUI opens with the `developer` preset selected. **Arrow keys** navigate, **Space** toggles packages, **Enter** confirms. Homebrew starts installing — usually 10–30 minutes depending on what you picked.
+The TUI checks your environment and asks you to choose a preset (`minimal`, `developer`, or `full`). Review the selected packages and setup options, then confirm the plan. Homebrew starts installing — usually 10–30 minutes depending on what you picked.
 
 When it finishes, restart your terminal or run: