Mole
𦑠Dig deep like a mole to clean your Mac.
## 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
## Installation
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
## Usage
```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 - Deeper system cleanup
==================================================
π Detected: Apple Silicon M3 | πΎ Free space: 245GB
------------------------------ System essentials ------------------------------
β User app cache (20.8GB)
β User app logs (190MB)
β Trash (5.4GB)
------------------------------ Browser cleanup --------------------------------
β Safari cache (320MB)
β Chrome cache (1.2GB)
β Arc cache (460MB)
------------------------------ Developer tools --------------------------------
β npm cache cleaned
β Docker resources cleaned
β Homebrew cache (940MB)
------------------------------ Cleanup summary --------------------------------
π Cleanup complete | πΎ Freed space: 38.6GB
π Items processed: 356 | πΎ Free space now: 253GB
===================================================================
```
## 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/