From 6a14aa33a10de4b953aa9d318bcecfad99db5ec1 Mon Sep 17 00:00:00 2001
From: Lucas Jahier <lucas.jahier@stratorys.com>
Date: Sun, 7 Jun 2026 06:05:10 +0200
Subject: [PATCH] docs: document Homebrew tap trust for existing installs

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index fd01bd3..3028595 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,21 @@ brew install mendral-ai/tap/mendral
 brew upgrade mendral
 ```
 
+## Tap trust
+
+Recent Homebrew versions (since 5.1.15) can require explicit trust for third-party taps (`HOMEBREW_REQUIRE_TAP_TRUST=1`, planned to become the default).
+If Homebrew refuses to load the formula or warns about an untrusted tap, run:
+
+```bash
+brew trust mendral-ai/tap
+```
+
+Or trust only the formula:
+
+```bash
+brew trust --formula mendral-ai/tap/mendral
+```
+
 ## About
 
 This repository contains the Homebrew formula for the Mendral CLI. It is updated automatically on each release.