diff --git a/.changeset/add-homebrew-install-docs.md b/.changeset/add-homebrew-install-docs.md
new file mode 100644
index 00000000..ff4e4a05
--- /dev/null
+++ b/.changeset/add-homebrew-install-docs.md
@@ -0,0 +1,5 @@
+---
+"@googleworkspace/cli": patch
+---
+
+Add Homebrew as an installation option in README
diff --git a/.gitignore b/.gitignore
index 668f55fc..e54327b9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -26,6 +26,9 @@ yarn-error.log*
 *.swo
 *~
 
+# AI agents
+.claude/settings.local.json
+
 # OS
 .DS_Store
 Thumbs.db
diff --git a/README.md b/README.md
index 9130ecbd..5eaf41a1 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,12 @@ A Nix flake is also available at `github:googleworkspace/cli`
 nix run github:googleworkspace/cli
 ```
 
+A Homebrew formula is also available (macOS):
+
+```bash
+brew install googleworkspace-cli
+```
+
 ## Quick Start
 
 ```bash