Mac Cleanup Wizard is a free and open-source desktop app that helps you identify and safely delete unwanted files, caches, logs, developer junk, and system bloat from your macOS system β all with an organized, intuitive UI.
Seeing "Apple could not verify Mac Cleanup Wizard is free of malware"? This is normal for unsigned open-source apps.
xattr -cr ~/Downloads/Mac\ Cleanup\ Wizard*.dmgThen right-click the app β "Open" (don't double-click!)
- Apple requires a $99/year developer certificate to avoid this warning
- As a free open-source project, we don't have Apple code signing
- The app is completely safe - you can review the source code
π Still having issues? Check our complete installation guide with multiple fix methods.
# Download and run compatibility check
curl -O https://raw.githubusercontent.com/SH20RAJ/mac-cleanup-wizard/main/check-compatibility.sh
chmod +x check-compatibility.sh && ./check-compatibility.sh-
Download the appropriate version:
- Apple Silicon (M1/M2/M3):
Mac Cleanup Wizard-1.0.0-arm64.dmg - Intel Mac:
Mac Cleanup Wizard-1.0.0.dmg
- Apple Silicon (M1/M2/M3):
-
Fix Security Warning (if needed):
xattr -cr ~/Downloads/Mac\ Cleanup\ Wizard*.dmg
-
Install: Double-click the DMG and drag to Applications
-
First Launch: Right-click the app β "Open" (don't double-click!)
π You're ready! The app will guide you through identifying and safely removing unnecessary files.
Mac Cleanup Wizard - Clean Your Mac Like a Pro
Main Dashboard Organized file categories with sizes |
Developer Files Scan Node.js, Python, Xcode cleanup |
Storage Analysis Visual disk usage breakdown |
Cleanup Progress Real-time cleanup results |
Over time, macOS can get cluttered with:
node_modules/- Python virtual environments
- Xcode derived data
- NPM/Yarn caches
- Mail attachments
- Chrome service workers
- Docker containers/images
- Unused apps and large media files
...and more!
This app provides an organized and visual approach to clean these intelligently, with safety checks, size previews, and one-click deletion.
- π Category-wise listing: Developer Files, Cache, Apps, Logs, Media, Downloads, and more
- π§ AI Assistant: Suggests what can be safely removed
- π File size sorter and preview
- π Trash bin visualizer
- π Admin permission prompt where needed
- π¦ One-click cleanup for selected categories
- π§ͺ Dry-run mode (see what would be deleted)
- Developer Junk
node_modules/,.venv/, Xcode derived data, Docker volumes
- Cache & Temp Files
- App caches, browser storage, system logs
- Media & Downloads
- Large videos, old screenshots, downloads
- App Data
- Old app support files and leftover data
- Miscellaneous
- iOS backups, Spotlight index, Time Machine snapshots
- Trash Management
- Frontend: Electron.js + React.js
- Backend / Scripts: Node.js (with native modules for file ops)
- Permissions: macOS elevated shell access (via
sudo) - AI Assistant (optional): OpenAI GPT-4 or local LLM for suggestions
Latest Release: v1.0.0
| Architecture | DMG Installer | ZIP Archive |
|---|---|---|
| Apple Silicon (M1/M2/M3) | Download DMG | Download ZIP |
| Intel (x64) | Download DMG | Download ZIP |
- Download the appropriate version for your Mac
- Fix Gatekeeper (required for unsigned apps):
xattr -cr ~/Downloads/Mac\ Cleanup\ Wizard*.dmg
- Install: Open DMG and drag to Applications
- First Launch: Right-click app β "Open" (important!)
Download and run our fix script:
curl -fsSL https://raw.githubusercontent.com/SH20RAJ/mac-cleanup-wizard/main/fix-gatekeeper.sh | bashπ Having issues? Check the complete installation guide.
- macOS 11 or later
- Node.js (v18+)
- NPM or Yarn
git clone https://github.com/sh20raj/mac-cleanup-wizard.git
cd mac-cleanup-wizard
npm installnpm run devnpm run buildWe welcome contributions! See CONTRIBUTING.md for setup instructions and guidelines.
This project is licensed under the MIT License.
If you like this tool, β star the repo, suggest ideas, and help spread the word!