mirror of https://github.com/tw93/Mole.git synced 2026-02-04 12:41:46 +00:00

Files

Tw93 6402ac3f4a Initial commit: Clean Mac v1.0.0

🧹 Deep Clean Your Mac with One Click

Features:
- Comprehensive cleanup for macOS cache and leftovers
- Apple Silicon optimizations
- Developer-friendly tool coverage
- Safe and transparent operation
- One-command installation

2025-09-23 14:35:26 +08:00

4.0 KiB

Raw Blame History

Clean Mac

🧹 Deep Clean Your Mac with One Click

Installation · Usage · What Gets Cleaned · Support

Features

🔥 More Thorough - Cleans significantly more cache than other tools
⚡ Dead Simple - Just one command, no complex setup or GUI
👀 Transparent & Safe - Open source code you can review and customize
🛡️ Zero Risk - Only touches safe cache files, never important data

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/tw93/clean-mac/main/install.sh | bash

Homebrew

brew tap tw93/tap
brew install clean-mac

Development

# Clone and run locally
git clone https://github.com/tw93/clean-mac.git
cd clean-mac && chmod +x clean.sh && ./clean.sh

Usage

clean              # Daily cleanup (no password required)
clean --system     # Deep system cleanup (password required)
clean --help       # Show help information

Example Output

🧹 Clean Mac - Deep Clean Your Mac with One Click
================================================
🍎 Detected: Apple Silicon (M-series) | 💾 Free space: 45.2GB
🚀 Mode: User-level cleanup (no password required)

▶ System essentials
  ✓ User app cache (1.2GB)
  ✓ User app logs (256MB)
  ✓ Trash (512MB)

▶ Browser cleanup
  ✓ Safari cache (845MB)
  ✓ Chrome cache (1.8GB)

▶ Developer tools
  ✓ npm cache cleaned
  ✓ Docker resources cleaned
  ✓ Homebrew cache (2.1GB)

🎉 User-level cleanup complete | 💾 Freed space: 8.45GB
📊 Items processed: 342 | 💾 Free space now: 53.7GB

What Gets Cleaned

Category	Items Cleaned	Safety Level
🗂️ System	App caches, logs, trash, crash reports, QuickLook thumbnails	✅ Safe
🌐 Browsers	Safari, Chrome, Edge, Arc, Brave, Firefox, Opera, Vivaldi	✅ Safe
💻 Developer	Node.js, Python, Go, Rust, Docker, Homebrew, Git, Cloud CLI	✅ Safe
🛠️ IDEs	Xcode, VS Code, JetBrains, Android Studio, Unity, Figma	✅ Safe
📱 Apps	Discord, Slack, Teams, Notion, 1Password, Steam, Epic Games	✅ Safe
🍎 Apple Silicon	Rosetta 2, M-series media cache, user activity cache	✅ Safe
🔒 System Deep	Font caches, iCloud sync, Adobe, VMs, system logs	⚠️ --system flag

🌐 Web Browsers

Safari cache & storage
Chrome/Chromium cache
Edge, Arc, Brave cache
Firefox, Opera cache

💻 Development Tools

npm, yarn, pnpm cache
pip, poetry, conda cache
Docker images & containers
Xcode derived data

📱 Applications

Discord, Slack cache
VS Code extensions cache
JetBrains IDE logs
Steam, Epic Games cache

🍎 Apple Silicon

Rosetta 2 cache
M-series optimizations
iOS device backups
Simulator cache

Support

If Clean Mac has been helpful to you:

Star this repository and share with fellow Mac users
Report issues or suggest new cleanup targets
I have two cats, if you think Clean helps you, you can feed them canned food 🥩🍤

4.0 KiB Raw Blame History