From 34d4ec4734d3c041903883d18f7779079a7649b1 Mon Sep 17 00:00:00 2001
From: Serhiy Zabolotnyy <zabolotnyy.s@gmail.com>
Date: Tue, 4 Aug 2026 13:26:37 +0300
Subject: [PATCH] Document Gatekeeper workaround

---
 README.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 95ed9c4..8159e4c 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,18 @@ brew install --cask micstatusai
 
 MicStatusAI supports Apple silicon Macs only.
 
-Automated releases are currently unsigned. macOS Gatekeeper may request confirmation before first launch.
+Automated releases are currently unsigned. macOS Gatekeeper may report the app as damaged after installation.
+
+### Temporary local workaround
+
+Only continue if you trust the downloaded MicStatusAI release. Remove the quarantine attribute, then open the app:
+
+```sh
+xattr -dr com.apple.quarantine /Applications/MicStatusAI.app
+open /Applications/MicStatusAI.app
+```
+
+If removing the attribute fails with a permission error, rerun the `xattr` command with `sudo`.
 
 ## Build