Skip to content

Expand README Gatekeeper section - #11

Merged
kylemclaren merged 1 commit into
mainfrom
docs/gatekeeper-readme
Jul 8, 2026
Merged

kylemclaren merged 1 commit into
mainfrom
docs/gatekeeper-readme

Conversation

@kylemclaren

Copy link
Copy Markdown
Owner

Rewrites the thin one-line quarantine note into a dedicated "Opening the app (Gatekeeper)" subsection under Install.

Why:

  • The old note only lived under the direct-download path, but since Homebrew 5.1 removed --no-quarantine, brew install --cask now gets quarantined too — so the guidance applies to both install paths.
  • Explains why it happens (unsigned/un-notarized, needs a paid Apple Developer account) so the "damaged"/"unidentified developer" scare is understood, not just worked around.
  • Presents the xattr -dr com.apple.quarantine command as the reliable fix and calls out that right-click → Open does not clear the "damaged" message Apple silicon shows for unsigned apps.

Docs-only; links to the existing Signing & distribution section.

🤖 Generated with Claude Code

Explain why the unsigned build is blocked, note it now affects the
Homebrew path too (5.1 dropped --no-quarantine), and give the reliable
xattr fix over right-click Open (which doesn't clear the "damaged" case
on Apple silicon).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@kylemclaren
kylemclaren merged commit e90c469 into main Jul 8, 2026
1 check passed
@kylemclaren
kylemclaren deleted the docs/gatekeeper-readme branch July 8, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant