Mac Sai deletes files on your Mac (at your user's privilege level) and can run a few maintenance commands via the standard macOS administrator prompt, so security matters more here than for most apps.
Please do not open public GitHub issues for security vulnerabilities.
Report them privately via GitHub's Private Vulnerability Reporting:
- Open the Security tab on the repository
- Click Report a vulnerability
- Include: the affected file or feature, reproduction steps, expected vs actual behavior, and a suggested fix if you have one
Expect an initial response within 72 hours. Issues that risk data loss get same-day attention.
Only the latest release on main is supported. Please upgrade rather than asking for backports.
| Version | Supported |
|---|---|
main (latest release) |
✅ |
| Older releases | ❌ |
Reports about the following areas get priority:
Sources/MacCleanKit/SafetyGuard.swift: bypasses of the protected-paths blocklist, the 10,000-file cap, or the symlink TOCTOU re-resolutionSources/MacClean/Core/Cleaner/CleaningEngine.swift: anything that causes data loss outside the intended scan resultsSources/MacClean/Modules/Maintenance/MaintenanceModule.swift: anything that turns the administrator-prompt maintenance commands into arbitrary command execution- Update checks: a tampered third-party update feed steering the user to a malicious download
- Network exfiltration: Mac Sai's only outbound calls are its own update check (the GitHub releases API) and reading third-party apps' update feeds; report any other network activity you observe
- TCC / Full Disk Access: any path to silently gain or abuse FDA
- General macOS bugs not specific to Mac Sai
- Findings that require an already-root or already-compromised machine
- Social engineering or physical access to an unlocked Mac
- Give us a reasonable window to fix before public disclosure: 14 days for non-critical issues, immediate coordination for anything that risks user data
- Don't test against other people's machines
- Don't pivot from a found vulnerability to access user data
- Credit in the release notes (or stay anonymous if you prefer)
- Acknowledgment in this file for significant findings
- Our genuine thanks. Mac Sai is safer because of you
Every release is signed with our Apple Developer ID and notarized by Apple, so your own Mac can confirm it is genuinely from us and has not been modified. Verify a downloaded DMG without trusting us:
# 1. The DMG carries a stapled Apple notarization ticket
xcrun stapler validate MacSai-1.9.0.dmg
# 2. Signed by our Developer ID, chaining to Apple
codesign -dvvv "Mac Sai.app" # Authority: Developer ID Application: Iliya Mirzaei (H3XLS95QV4)
# 3. Gatekeeper's own verdict
spctl -a -vvv "Mac Sai.app" # accepted, source=Notarized Developer IDsource=Notarized Developer ID is your Mac confirming with Apple that this exact binary was notarized and signed by team H3XLS95QV4. No one without our Developer ID certificate can reproduce that result.
Notarization proves who signed a build, not that it matches this repo. To additionally confirm a release was built from the public source, build it yourself:
git clone https://github.com/iliyami/MacSai.git
cd MacSai
git checkout v1.9.0
bash scripts/build-dmg.shThe DMG is not bit-for-bit reproducible (signatures embed timestamps and nonces), but the source-to-binary build is straightforward and the behavior should match.
None yet. Will be linked here when applicable.