From f3ab86d550b9b72831e2dc42e2a68bf92bd9943b Mon Sep 17 00:00:00 2001 From: Muhammad Rayhan Hamada Budiman Date: Thu, 19 Nov 2026 06:58:55 +0700 Subject: [PATCH] docs: document the Gatekeeper first-launch limitation Release builds are ad-hoc signed, so Homebrew 7 quarantine requires one-time approval. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index e3f6eba..6b866a2 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,15 @@ other Mac app. Homebrew 7 requires trusting third-party casks before installation. On older Homebrew versions the `brew trust` step can be skipped. +### Gatekeeper + +Release builds are ad-hoc signed, not notarized. Homebrew 7 quarantines +downloads, so macOS blocks the first launch. Approve the app once in +**System Settings → Privacy & Security → Open Anyway**. + +Removing that prompt requires Apple Developer ID signing and notarization in +the release workflow. + If you installed the old formula, remove it before switching: ```sh