Mole
π§Ή Like a mole, dig deep to clean your mac.
## Features
- π¦ Deep Clean: System/user caches, logs, temp and more
- π‘οΈ Safe by default: Skips critical system and input method settings
- π App Uninstall: Remove app bundle and related data comprehensively
- π» Smooth TUI: Fast arrow-key menus with pagination for large lists
## Installation
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
## Usage
```bash
mole # Interactive main menu
mole clean # Deep clean (smart sudo handling)
mole uninstall # Interactive app uninstaller
mole --help # Show help
```
### Example Output
```bash
π³οΈ Mole - System Cleanup
========================
π Detected: Apple Silicon | πΎ Free space: 45.2GB
π Mode: User-level cleanup (no password required)
βΆ System essentials
β User app cache
β User app logs
β Trash
βΆ Browser cleanup
β Safari cache
β Chrome cache
βΆ Developer tools
β npm cache
β Docker resources
β Homebrew cache
π Cleanup complete | πΎ Freed space: 8.45GB
π Items processed: 342 | πΎ Free space now: 53.7GB
```
## What Gets Cleaned
| 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 |
## Uninstaller
- 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/