Troubleshooting (QA)

macOS says the app is damaged

macOS · Beta

The Beta app is not publisher-signed or notarized by Apple. macOS may block it on first launch; this warning alone does not mean the file is damaged.

Verify the download
Use the installer from this project’s GitHub Release and confirm that its SHA-256 matches the published checksum.
Move the app to Applications
Open the DMG and drag Codex Switch into Applications.
Run this command in Terminal
Paste the command below and press Return.
Terminal
```
xattr -dr com.apple.quarantine "/Applications/Codex Switch.app"
```
Open Codex Switch again
Launch Codex Switch from Applications. If it still fails, keep the error message and report it.

This command only removes the app’s download quarantine attribute. It does not disable system-wide security or repair a damaged file.