From 254c45685ea24111c0890f193646b7c060c73189 Mon Sep 17 00:00:00 2001
From: fate <fate@fates-MacBook-Pro.local>
Date: Tue, 28 Apr 2026 14:53:26 -0400
Subject: [PATCH] docs: add Homebrew install option

A Homebrew formula now lives in alphaonedev/homebrew-tap (added in
that repo's PR #2). End-to-end verified locally: tap visible,
brew install grok-cli completes, ad-hoc signature intact, no
quarantine attribute, --version reports 1.7.0, clean uninstall.

- README.md: New "Homebrew (macOS arm64 + Linux x64)" section above
  the curl-pipe install. Notes that the formula's Gatekeeper handling
  covers ad-hoc-signed binaries.
- docs/index.html: Hero now shows two install boxes (brew + curl)
  side by side. copyInstall() generalized to accept (codeId, btnId)
  args so each copy button targets its own snippet; defaults preserve
  the prior behavior.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md       | 13 ++++++++++++-
 docs/index.html | 24 +++++++++++++++++-------
 2 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 842b856f..f6843c68 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,18 @@ Community-built and unofficial. Not affiliated with or endorsed by xAI.
 
 ## Install
 
-### One-line install (recommended)
+### Homebrew (macOS arm64 + Linux x64)
+
+```bash
+brew tap alphaonedev/homebrew-tap
+brew install grok-cli
+```
+
+The formula tracks the latest release. Upgrade with `brew upgrade grok-cli`.
+The macOS binary is ad-hoc signed; brew strips the Gatekeeper quarantine
+attribute automatically. Apple Developer ID notarization is on the roadmap.
+
+### One-line install (recommended for non-brew users)
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/alphaonedev/grok-cli/main/install.sh | bash
diff --git a/docs/index.html b/docs/index.html
index d7bd8769..534044f2 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -112,10 +112,17 @@ <h3>Built for Developers</h3>
     </div>
     <div class="install-box">
       <div class="install-header">
-        <h3>Install</h3>
-        <button class="copy-btn" id="copy-btn" onclick="copyInstall()" title="Copy to clipboard">Copy</button>
+        <h3>Install (Homebrew)</h3>
+        <button class="copy-btn" id="copy-btn-brew" onclick="copyInstall('install-cmd-brew', 'copy-btn-brew')" title="Copy to clipboard">Copy</button>
       </div>
-      <code id="install-cmd" onclick="copyInstall()">curl -fsSL https://raw.githubusercontent.com/alphaonedev/grok-cli/main/install.sh | bash</code>
+      <code id="install-cmd-brew" onclick="copyInstall('install-cmd-brew', 'copy-btn-brew')">brew tap alphaonedev/homebrew-tap &amp;&amp; brew install grok-cli</code>
+    </div>
+    <div class="install-box" style="margin-top:12px;">
+      <div class="install-header">
+        <h3>Install (curl)</h3>
+        <button class="copy-btn" id="copy-btn" onclick="copyInstall('install-cmd', 'copy-btn')" title="Copy to clipboard">Copy</button>
+      </div>
+      <code id="install-cmd" onclick="copyInstall('install-cmd', 'copy-btn')">curl -fsSL https://raw.githubusercontent.com/alphaonedev/grok-cli/main/install.sh | bash</code>
     </div>
   </div>
 </header>
@@ -378,16 +385,19 @@ <h2>Built with</h2>
 </footer>
 
 <script>
-function copyInstall() {
-  var text = document.getElementById('install-cmd').textContent;
-  var btn = document.getElementById('copy-btn');
+function copyInstall(codeId, btnId) {
+  codeId = codeId || 'install-cmd';
+  btnId = btnId || 'copy-btn';
+  var codeEl = document.getElementById(codeId);
+  var btn = document.getElementById(btnId);
+  var text = codeEl.textContent;
   navigator.clipboard.writeText(text).then(function() {
     btn.textContent = 'Copied!';
     btn.classList.add('copied');
     setTimeout(function() { btn.textContent = 'Copy'; btn.classList.remove('copied'); }, 2000);
   }).catch(function() {
     var r = document.createRange();
-    r.selectNodeContents(document.getElementById('install-cmd'));
+    r.selectNodeContents(codeEl);
     var s = window.getSelection();
     s.removeAllRanges();
     s.addRange(r);