Mole
🦡 Dig deep like a mole to clean your Mac.
A Bash toolkit that tunnels through caches, leftovers, and forgotten libraries so your macOS stays fast without risking the essentials.
## Highlights
- 🦡 Deep-clean hidden caches, logs, and temp files in one sweep
- 🛡 Guardrails built in: skip vital macOS and input method data
- 📦 Smart uninstall removes apps together with every leftover directory
- ⚡️ Fast arrow-key TUI with pagination for big app lists
## Install & Update
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
## Daily Commands
```bash
mole # Interactive main menu
mole clean # Deeper system cleanup
mole uninstall # Interactive app uninstaller
mole --help # Show help
```
### Quick Peek
```bash
$ mole clean
🦡 MOLE — Dig deep like a mole to clean your Mac.
Collecting inventory ...
▶ System essentials freed 3.1GB (caches, logs, trash)
▶ Browser cleanup freed 820MB (Safari, Chrome, Arc)
▶ Developer tools freed 4.6GB (npm, Docker, Homebrew)
🎉 Done! 8.5GB reclaimed across 342 items.
💡 Tip: run `mole --help` to discover more commands.
```
## What Mole Cleans
| Category | Items Cleaned | Safety |
|---|---|---|
| 🗂️ System | App caches, logs, trash, crash reports, QuickLook thumbnails | Safe |
| 🌐 Browsers | Safari, Chrome, Edge, Arc, Brave, Firefox, Opera, Vivaldi | Safe |
| 💻 Developer | Node.js/npm, Python/pip, Go, Rust/cargo, Docker, Homebrew, Git | Safe |
| 🛠️ IDEs | Xcode, VS Code, JetBrains, Android Studio, Unity, Figma | Safe |
| 📱 Apps | Common app caches (e.g., Slack, Discord, Teams, Notion, 1Password) | Safe |
| 🍎 Apple Silicon | Rosetta 2, media services, user activity caches | Safe |
## Smart Uninstall
- Fast scan of `/Applications` with system-app filtering (e.g., `com.apple.*`)
- Ranks apps by last used time and shows size hints
- Two modes: batch multi-select (checkbox) or quick single-select
- Detects running apps and force‑quits them before removal
- Single confirmation for the whole batch with estimated space to free
- Cleans thoroughly and safely:
- App bundle (`.app`)
- `~/Library/Application Support/