diff --git a/README.md b/README.md
index 60ee12f2a..d6ad84b62 100644
--- a/README.md
+++ b/README.md
@@ -62,7 +62,7 @@ curl -fsSL https://nubjs.com/install.sh | bash
 irm https://nubjs.com/install.ps1 | iex
 
 # Homebrew (macOS / Linux)
-brew install nubjs/tap/nub
+brew install nub
 
 # Nix (flakes)
 nix run github:nubjs/nub
@@ -74,6 +74,13 @@ mise use -g nub
 npm install -g @nubjs/nub
 ```
 
+> [!NOTE]
+> Switching an existing `nubjs/tap` install over to the core formula takes an uninstall first:
+>
+> ```sh
+> brew uninstall nubjs/tap/nub && brew untap nubjs/tap && brew install nub
+> ```
+
 For GitHub Actions, use [`nubjs/setup-nub`](https://github.com/nubjs/setup-nub) in place of `actions/setup-node`. It's one-to-one compatible.
 
 ```diff
diff --git a/site/content/docs/faq.mdx b/site/content/docs/faq.mdx
index e534601f6..824185d77 100644
--- a/site/content/docs/faq.mdx
+++ b/site/content/docs/faq.mdx
@@ -376,7 +376,7 @@ Same as installing — match how you installed: `brew update && brew upgrade nub
 
 ## Is there a curl install script?
 
-Yes. On macOS and Linux, `curl -fsSL https://nubjs.com/install.sh | bash`; on Windows, `powershell -c "irm https://nubjs.com/install.ps1 | iex"`. Both drop a native binary into `~/.nub` and put it on your `PATH`. The scripts verify the release archive against its SHA-256 sidecar before replacing an existing installation. This detects corrupt, truncated, stale-cache, or mismatched assets; it is not an independent authenticity guarantee because the archive and checksum share the same release origin. If you'd rather go through your package manager, `npm install -g @nubjs/nub` (or `pnpm add -g` / `yarn global add`) does the same thing, and on macOS and Linux `brew install nubjs/tap/nub` works too.
+Yes. On macOS and Linux, `curl -fsSL https://nubjs.com/install.sh | bash`; on Windows, `powershell -c "irm https://nubjs.com/install.ps1 | iex"`. Both drop a native binary into `~/.nub` and put it on your `PATH`. The scripts verify the release archive against its SHA-256 sidecar before replacing an existing installation. This detects corrupt, truncated, stale-cache, or mismatched assets; it is not an independent authenticity guarantee because the archive and checksum share the same release origin. If you'd rather go through your package manager, `npm install -g @nubjs/nub` (or `pnpm add -g` / `yarn global add`) does the same thing, and on macOS and Linux `brew install nub` works too.
 
 Two environment variables customize the script, following the same convention as rustup and uv:
 
diff --git a/site/content/docs/index.mdx b/site/content/docs/index.mdx
index adac05a30..4425608ed 100644
--- a/site/content/docs/index.mdx
+++ b/site/content/docs/index.mdx
@@ -46,7 +46,7 @@ npm install -g @nubjs/nub
 Both `pnpm add -g @nubjs/nub` and `yarn global add @nubjs/nub` work too. That installs the Rust binary plus the platform-specific N-API addons, and puts `nub` and `nubx` on your `PATH`. On macOS and Linux, install with Homebrew:
 
 ```bash
-brew install nubjs/tap/nub
+brew install nub
 ```
 
 With [mise](https://mise.jdx.dev), `nub` and `nubx` both land on `PATH`:
diff --git a/site/content/docs/node.mdx b/site/content/docs/node.mdx
index 3bae89764..1cf817eea 100644
--- a/site/content/docs/node.mdx
+++ b/site/content/docs/node.mdx
@@ -177,7 +177,7 @@ With no pin the explainer reads `» resolved from node on PATH`. Bare `nub node`
 
 ## `nub node shim`
 
-Make `node` itself resolve through Nub, so a machine with no Node installed can run `node` at all. This is the fresh-install story: `brew install nubjs/tap/nub` (or the curl script), `nub node shim`, and now a bare `node file.js` works — Nub resolves the right version, provisions it if it's missing, and runs it.
+Make `node` itself resolve through Nub, so a machine with no Node installed can run `node` at all. This is the fresh-install story: `brew install nub` (or the curl script), `nub node shim`, and now a bare `node file.js` works — Nub resolves the right version, provisions it if it's missing, and runs it.
 
 ```console
 $ nub node shim
diff --git a/site/public/start.md b/site/public/start.md
index 6ba71aa43..c37b055ed 100644
--- a/site/public/start.md
+++ b/site/public/start.md
@@ -45,7 +45,7 @@ curl -fsSL https://nubjs.com/install.sh | bash
 # Windows (PowerShell)
 irm https://nubjs.com/install.ps1 | iex
 # Homebrew (macOS / Linux)
-brew install nubjs/tap/nub
+brew install nub
 # mise
 mise use -g nub
 # or via any package manager
diff --git a/site/src/components/install-tabs.tsx b/site/src/components/install-tabs.tsx
index 0c2ea1ed2..b9cbfc181 100644
--- a/site/src/components/install-tabs.tsx
+++ b/site/src/components/install-tabs.tsx
@@ -11,7 +11,7 @@ type Tab = { id: TabId; label: string; command: string };
 // Windows drops Homebrew entirely. mise and npm work everywhere.
 const UNIX_TABS: Tab[] = [
   { id: 'unix', label: 'curl', command: 'curl -fsSL https://nubjs.com/install.sh | bash' },
-  { id: 'brew', label: 'Homebrew', command: 'brew install nubjs/tap/nub' },
+  { id: 'brew', label: 'Homebrew', command: 'brew install nub' },
   { id: 'npm', label: 'npm', command: 'npm install -g @nubjs/nub' },
   { id: 'mise', label: 'mise', command: 'mise use -g nub' },
 ];