From 4d8097a56fe9990eb2e5cecb6d167eb6897eda06 Mon Sep 17 00:00:00 2001
From: n33pm <12273891+n33pm@users.noreply.github.com>
Date: Fri, 6 Feb 2026 20:23:06 +0100
Subject: [PATCH] docs: add Homebrew installation instructions for macOS (#385)

---
 README.md                          | 7 +++++++
 docs/src/app/installation/page.tsx | 6 ++++++
 docs/src/app/page.tsx              | 6 +++++-
 3 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 570e608..49bc0d9 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,13 @@ npm install -g agent-browser
 agent-browser install  # Download Chromium
 ```
 
+### Homebrew (macOS)
+
+```bash
+brew install agent-browser
+agent-browser install  # Download Chromium
+```
+
 ### From Source
 
 ```bash
diff --git a/docs/src/app/installation/page.tsx b/docs/src/app/installation/page.tsx
index afc11ba..3d02c60 100644
--- a/docs/src/app/installation/page.tsx
+++ b/docs/src/app/installation/page.tsx
@@ -10,6 +10,12 @@ export default function Installation() {
         <CodeBlock code={`npm install -g agent-browser
 agent-browser install  # Download Chromium`} />
 
+        <h2>Homebrew (macOS)</h2>
+        <CodeBlock
+          code={`brew install agent-browser
+agent-browser install  # Download Chromium`}
+        />
+
         <h2>From source</h2>
         <CodeBlock code={`git clone https://github.com/vercel-labs/agent-browser
 cd agent-browser
diff --git a/docs/src/app/page.tsx b/docs/src/app/page.tsx
index 25e104f..7bd3fd2 100644
--- a/docs/src/app/page.tsx
+++ b/docs/src/app/page.tsx
@@ -9,7 +9,11 @@ export default function Home() {
           Browser automation CLI designed for AI agents. Compact text output minimizes context usage. Fast Rust CLI with Node.js fallback.
         </p>
 
-        <CodeBlock code="npm install -g agent-browser" />
+        <CodeBlock
+          code={`
+npm install -g agent-browser      # all platforms
+brew install agent-browser        # macOS`}
+        />
 
         <h2>Features</h2>
         <ul>