Mole
๐ฆก Dig deep like a mole to clean your Mac.
## Highlights
- ๐ฆก **Deep System Cleanup** - Remove hidden caches, logs, and temp files in one sweep
- ๐ฆ **Smart Uninstall** - Complete app removal with all related files and folders
- ๐ **Disk Space Analyzer** - Visualize disk usage with lightning-fast mdfind + du hybrid scanning
- โก๏ธ **Fast Interactive UI** - Arrow-key navigation with pagination for large lists
- ๐งน **Massive Space Recovery** - Reclaim 100GB+ of wasted disk space
## Installation
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
## Usage
```bash
mole # Interactive main menu
mole clean # Deep system cleanup
mole uninstall # Interactive app uninstaller
mole analyze [path]# Analyze disk space (default: home directory)
mole --help # Show help
```
## Examples
### Deep System Cleanup
```bash
$ mole clean
Starting user-level cleanup...
โถ System essentials
โ User app cache (28 items) (45.2GB)
โ User app logs (15 items) (2.1GB)
โ Trash (12.3GB)
โถ Browser cleanup
โ Chrome cache (8 items) (8.4GB)
โ Safari cache (2.1GB)
โ Arc cache (3.2GB)
โถ Extended developer caches
โ Xcode derived data (9.1GB)
โ Node.js cache (4 items) (14.2GB)
โ VS Code cache (1.4GB)
โถ Applications
โ JetBrains cache (3.8GB)
โ Slack cache (2.2GB)
โ Discord cache (1.8GB)
====================================================================
๐ CLEANUP COMPLETE!
๐พ Space freed: 95.50GB | Free space now: 223.5GB
๐ Files cleaned: 6420 | Categories processed: 6
====================================================================
```
### Smart App Uninstaller
```bash
$ mole uninstall
Select Apps to Remove
โถ โ Adobe Creative Cloud (12.4G) | Old
โ WeChat (2.1G) | Recent
โ Final Cut Pro (3.8G) | Recent
๐๏ธ Uninstalling: Adobe Creative Cloud
โ Removed application
โ Cleaned 45 related files
====================================================================
๐ UNINSTALLATION COMPLETE!
๐๏ธ Apps uninstalled: 1 | Space freed: 12.4GB
====================================================================
```
### Disk Space Analyzer
```bash
# Quick start - explore your home directory
$ mole analyze
# View all disk volumes and major locations
$ mole analyze --all
๐พ Disk Volumes & Locations
TYPE SIZE LOCATION
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โถ ๐ฟ 245.3GB Macintosh HD (Root)
๐ 89.2GB ~
๐ 45.1GB ~/Library
๐ 33.7GB ~/Downloads
๐ 18.4GB ~/Documents
๐ 128.0GB External Drive
# Explore specific directory with progress bar
$ mole analyze ~/Downloads
๐ [โโโโโโโโโโโโ] 100% (25/25) โ Real-time scanning progress
๐ Disk Space Explorer
Current: ~/Downloads
โ/โ: Navigate | โ / Enter: Open folder | โ / Backspace: Back | q: Quit
Items (sorted by size):
TYPE SIZE NAME
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โถ ๐ 33.72GB materials โ Use arrow keys to select
๐ 5.67GB learning
๐ 4.50GB projects
๐ฌ 1.68GB recording.mov โ Files can't be opened
๐ฌ 1.58GB presentation.mov
๐ฆ 1.20GB OldInstaller.dmg
๐ 2.22GB shared
๐ 1.78GB recent
... and 12 more items
# Press Enter on "materials" folder to drill down:
๐ Disk Space Explorer
Current: ~/Downloads/materials
โ/โ: Navigate | โ / Enter: Open folder | โ / Backspace: Back | q: Quit
Items (sorted by size):
โถ ๐ 15.2GB videos โ Keep drilling down
๐ 10.1GB documents
๐ 6.8GB images
๐ฌ 2.5GB demo.mov
```
**Interactive Navigation:**
- **Instant startup** - no waiting for initial scan
- **Real-time progress** - visual progress bar when scanning (10+ directories)
- **All volumes view** - `--all` flag shows all disks and major locations
- **Files and folders mixed together**, sorted by size (largest first)
- Shows **top 16 items** per directory (largest items only)
- Use **โ/โ** arrow keys to navigate (green arrow โถ shows selection)
- Press **Enter** on a ๐ folder to drill down into it
- Press **Backspace** or **โ** to go back to parent directory
- Press **q** to quit at any time
- **Color coding**: Red folders >10GB, Yellow >1GB, Blue <1GB
- Files (๐ฆ๐ฌ๐๐ผ๏ธ๐) are shown but can't be opened (only folders)
**Performance:**
- **Fast scanning** - real-time progress bar for large directories (10+ folders)
- **Smart caching** - sizes are calculated once and cached during navigation
- **Top 16 only** - shows largest items first, keeps interface clean and fast
## What Mole Cleans
| Category | Targets | Typical Recovery |
|----------|---------|------------------|
| **System** | App caches, logs, trash, crash reports | 20-50GB |
| **Browsers** | Safari, Chrome, Edge, Arc, Firefox cache | 5-15GB |
| **Developer** | npm, pip, Docker, Homebrew, Xcode | 15-40GB |
| **Apps** | Slack, Discord, Teams, Notion cache | 3-10GB |
## What Mole Uninstalls
| Component | Files Removed | Examples |
|-----------|--------------|----------|
| **App Bundle** | Main .app executable | `/Applications/App.app` |
| **Support Data** | App-specific user data | `~/Library/Application Support/AppName` |
| **Cache Files** | Temporary & cache data | `~/Library/Caches/com.company.app` |
| **Preferences** | Settings & config files | `~/Library/Preferences/com.app.plist` |
| **Logs & Reports** | Crash reports & logs | `~/Library/Logs/AppName` |
| **Containers** | Sandboxed app data | `~/Library/Containers/com.app.id` |
## Support
If Mole helps you recover disk space, star this repository and share with fellow Mac users. Report issues via [GitHub Issues](https://github.com/tw93/mole/issues).
I have two cats, you can