diff --git a/README.md b/README.md
index 20813de3eb3..94bc87d4ec1 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,9 @@ npm install -g @google/gemini-cli
 
 #### Install globally with Homebrew (macOS/Linux)
 
+> **Note:** The `gemini-cli` formula is deprecated in `homebrew-core`. For the
+> most up-to-date version, use npm or another method above.
+
 ```bash
 brew install gemini-cli
 ```
diff --git a/docs/get-started/installation.mdx b/docs/get-started/installation.mdx
index 52342f57a42..be404531322 100644
--- a/docs/get-started/installation.mdx
+++ b/docs/get-started/installation.mdx
@@ -39,6 +39,10 @@ installation methods. Note that Gemini CLI comes pre-installed on
   </TabItem>
   <TabItem label="Homebrew (macOS/Linux)">
 
+  :::caution
+  The `gemini-cli` formula is deprecated in `homebrew-core`. For the most up-to-date version, use npm or another installation method.
+  :::
+
   Install globally with Homebrew:
 
   ```bash
diff --git a/packages/cli/src/utils/installationInfo.test.ts b/packages/cli/src/utils/installationInfo.test.ts
index ad55efda32d..7c72fb5755b 100644
--- a/packages/cli/src/utils/installationInfo.test.ts
+++ b/packages/cli/src/utils/installationInfo.test.ts
@@ -177,7 +177,8 @@ describe('getInstallationInfo', () => {
     expect(info.packageManager).toBe(PackageManager.HOMEBREW);
     expect(info.isGlobal).toBe(true);
     expect(info.updateMessage).toBe(
-      'Installed via Homebrew. Please update with "brew upgrade gemini-cli".',
+      'Installed via Homebrew (deprecated in homebrew-core). ' +
+        'For the latest version, migrate to npm: npm install -g @google/gemini-cli',
     );
   });
 
diff --git a/packages/cli/src/utils/installationInfo.ts b/packages/cli/src/utils/installationInfo.ts
index 3db736d8d50..3abac7dcd3a 100644
--- a/packages/cli/src/utils/installationInfo.ts
+++ b/packages/cli/src/utils/installationInfo.ts
@@ -108,7 +108,8 @@ export function getInstallationInfo(
             packageManager: PackageManager.HOMEBREW,
             isGlobal: true,
             updateMessage:
-              'Installed via Homebrew. Please update with "brew upgrade gemini-cli".',
+              'Installed via Homebrew (deprecated in homebrew-core). ' +
+              'For the latest version, migrate to npm: npm install -g @google/gemini-cli',
           };
         }
       } catch {