Skip to content

fix: add xattr workaround for macOS Gatekeeper warning#2754

Merged
markphelps merged 1 commit intomainfrom
mphelps/macos-xattr-workaround
Feb 20, 2026
Merged

fix: add xattr workaround for macOS Gatekeeper warning#2754
markphelps merged 1 commit intomainfrom
mphelps/macos-xattr-workaround

Conversation

@markphelps
Copy link
Contributor

@markphelps markphelps commented Feb 20, 2026

Summary

  • Adds xattr -d com.apple.quarantine workaround to tools/install.sh and docs/getting-started.md to prevent the macOS Gatekeeper "cannot be opened because the developer cannot be verified" warning on unsigned binaries
  • Adds a troubleshooting note in the getting started docs for users who download the binary via a browser

This is an immediate stopgap until proper code signing and notarization are added.

Closes #2738

…naries

Remove the com.apple.quarantine attribute after downloading cog on macOS
to prevent the 'cannot be opened because the developer cannot be verified'
Gatekeeper warning. This is a stopgap until proper code signing is added.

- tools/install.sh: clear quarantine attribute after chmod on macOS
- docs/getting-started.md: add xattr to install snippet + troubleshooting note
- docs/llms.txt: regenerated

Closes #2738
@markphelps markphelps requested a review from a team as a code owner February 20, 2026 14:42
@markphelps markphelps merged commit ba0d5c5 into main Feb 20, 2026
27 checks passed
@markphelps markphelps deleted the mphelps/macos-xattr-workaround branch February 20, 2026 15:14
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.

Fix codesigning on release binaries

2 participants