From c5e8433a66ab4b01041a185669cc7185a52de024 Mon Sep 17 00:00:00 2001
From: gouravkrosx <gouravgreatkr@gmail.com>
Date: Fri, 29 May 2026 09:32:11 +0000
Subject: [PATCH 1/2] docs(macos-install): restore Homebrew install as option 2

Revert the Homebrew comment-outs from #867 now that the keploy/tap
formula is expected to work. Restores `brew install keploy/tap/keploy`
as a second documented install path, alongside the one-click curl
installer which remains the recommended primary option.

- Re-enable the "Install with Homebrew" HowTo schema step (now step 2,
  curl one-click stays as step 1 / recommended).
- Re-add the visible "## Install with Homebrew" section.
- Restore the two-option intro list; keep Manual Setup as the eBPF
  fallback below.
- Put `homebrew` / `brew install keploy` back in frontmatter keywords
  and the page description.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: gouravkrosx <gouravgreatkr@gmail.com>
---
 .../server/macos/installation.md              | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/versioned_docs/version-4.0.0/server/macos/installation.md b/versioned_docs/version-4.0.0/server/macos/installation.md
index 0d9015525..1726e5a0c 100644
--- a/versioned_docs/version-4.0.0/server/macos/installation.md
+++ b/versioned_docs/version-4.0.0/server/macos/installation.md
@@ -2,7 +2,7 @@
 id: installation
 title: macOS Installation
 sidebar_label: macOS
-description: "Install Keploy on macOS with the one-click curl installer. Docker Desktop and Colima setups are also supported for eBPF testing."
+description: "Install Keploy on macOS with the one-click curl installer or Homebrew. Docker Desktop and Colima setups are also supported for eBPF testing."
 tags:
   - hello-world
   - macos
@@ -20,35 +20,40 @@ keywords:
   - guide
   - api
   - docker
+  - homebrew
+  - brew install keploy
 ---
 
 import HowTo from '@site/src/components/HowTo';
 
 <HowTo
 name="Install Keploy on macOS"
-description="Install the Keploy CLI on macOS using the one-click curl installer."
+description="Install the Keploy CLI on macOS using the one-click curl installer or Homebrew."
 totalTime="PT5M"
 estimatedCost={{currency: "USD", value: "0"}}
-tools={["bash", "curl"]}
+tools={["bash", "curl", "Homebrew (optional)"]}
 supplies={["A macOS machine"]}
 visible={false}
 steps={[
 {
-name: "One-click install",
+name: "One-click install (recommended)",
 text: "Run: curl --silent -O -L https://keploy.io/install.sh && source install.sh",
 url: "#one-click-install-keploy",
 },
-/* Homebrew install temporarily disabled — the keploy/tap formula has known issues being resolved. Re-enable this step (and the "Install with Homebrew" section below) once the tap is fixed.
 {
 name: "Install with Homebrew",
 text: "Run: brew install keploy/tap/keploy",
 url: "#install-with-homebrew",
 },
-*/
 ]}
 />
 
-The recommended way to install Keploy on macOS is the **one-click curl installer**. For users who need eBPF support, a [manual setup with Docker Desktop or Colima](#manual-setup) is also available.
+There are two ways to install Keploy on macOS:
+
+1. [One-click install](#one-click-install-keploy) — **recommended**.
+2. [Install with Homebrew](#install-with-homebrew).
+
+For users who need eBPF support, a [manual setup with Docker Desktop or Colima](#manual-setup) is also available.
 
 ## One-click install Keploy
 
@@ -58,11 +63,8 @@ Run the following command in your terminal:
  curl --silent -O -L https://keploy.io/install.sh && source install.sh
 ```
 
-<!--
 ## Install with Homebrew
 
-_Homebrew installation is temporarily disabled while we resolve known issues with the `keploy/tap` formula. Once fixed, this section will be restored._
-
 If you prefer [Homebrew](https://brew.sh/), install Keploy from the official Keploy tap:
 
 ```shell
@@ -74,7 +76,6 @@ Verify the install:
 ```shell
 keploy --version
 ```
--->
 
 ## Manual Setup
 

From c419272db1b6d8bfdba9703be4e9f6c55047db35 Mon Sep 17 00:00:00 2001
From: gouravkrosx <gouravgreatkr@gmail.com>
Date: Fri, 29 May 2026 10:39:04 +0000
Subject: [PATCH 2/2] docs(macos-install): drop em-dash in intro list to
 satisfy Vale
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Vale's Google.EmDash rule flags ` — ` (space-em-dash-space) in the
visible markdown prose. The HowTo JSX block is BlockIgnored in
.vale.ini, but the intro list outside it isn't. Reword the recommended
marker as a bold prefix instead of an em-dash trailer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: gouravkrosx <gouravgreatkr@gmail.com>
---
 versioned_docs/version-4.0.0/server/macos/installation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/versioned_docs/version-4.0.0/server/macos/installation.md b/versioned_docs/version-4.0.0/server/macos/installation.md
index 1726e5a0c..89f4a5d44 100644
--- a/versioned_docs/version-4.0.0/server/macos/installation.md
+++ b/versioned_docs/version-4.0.0/server/macos/installation.md
@@ -50,7 +50,7 @@ url: "#install-with-homebrew",
 
 There are two ways to install Keploy on macOS:
 
-1. [One-click install](#one-click-install-keploy) — **recommended**.
+1. **Recommended:** [One-click install](#one-click-install-keploy).
 2. [Install with Homebrew](#install-with-homebrew).
 
 For users who need eBPF support, a [manual setup with Docker Desktop or Colima](#manual-setup) is also available.