Mac Cleaner

AI-Powered Mac Cleaning Assistant

Scan your Mac for junk files and free up disk space safely. Cleans 100+ types of caches, logs, and build artifacts.

Quick Start

./start.sh

Or manually:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

Requirements

• macOS
• Python 3.8+
• GitHub Copilot subscription

Commands

Command	Description
scan	Find all cleanable items
clean	Interactive cleanup
quick	Clean safe items only
status	Show disk space
large	Find large unused files
purge	Find project artifacts
uninstall	Remove App & leftovers

Or type naturally: "clean browser caches", "clean npm cache"

What It Cleans

System: Caches, logs, crash reports, trash, temp files, .DS_Store

Browsers: Chrome, Firefox, Safari, Edge, Brave, Arc

Node.js: npm, yarn, pnpm, bun, tnpm

Python: pip, pyenv, poetry, uv, ruff, conda, huggingface, torch, tensorflow

Rust/Go: cargo, rustup, go cache

Java/Android: gradle, maven, Android Studio

Xcode: DerivedData, archives, device support, simulators

Editors: VS Code, Cursor, JetBrains

Apps: Discord, Slack, Zoom, Teams, Telegram, WhatsApp, WeChat, DingTalk

Cloud: Dropbox, OneDrive, iCloud, Google Drive

Docker: images, containers, volumes, buildx

Projects: node_modules, target, build, venv, pycache

Applications: Clean uninstall of apps and all related files (Application Support, Caches, Preferences, Containers)

System: Time Machine, Spotlight, DNS, QuickLook, macOS Install Data

License

MIT