diff --git a/README.md b/README.md
index a66ffea..22f85cc 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,5 @@
-

-
Mole
+
Mole
๐ฆก Dig deep like a mole to clean your Mac.
@@ -13,14 +12,21 @@
-## Highlights
+
+
+
+
+## Features at a Glance
- ๐ฆ **Deep System Cleanup** - Remove hidden caches, logs, and temp files in one sweep
- ๐ฆ **Thorough Uninstall** - 22+ locations cleaned vs 1 standard, beats CleanMyMac/Lemon
+- ๐ **Interactive Disk Analyzer** - Navigate folders like a file manager, find and delete large files instantly
- โก๏ธ **Fast & Lightweight** - Terminal-based, zero bloat, arrow-key navigation with pagination
- ๐งน **Massive Space Recovery** - Reclaim 100GB+ of wasted disk space
-## Installation
+## Quick Start
+
+**Install:**
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
@@ -32,111 +38,111 @@ Or via Homebrew:
brew install tw93/tap/mole
```
-> Pick one method to avoid conflicts, new users check [ๅฐ็ฝไฝฟ็จๆๅ](./GUIDE.md)
-
-## Usage
+**Run:**
```bash
-mole # Interactive main menu
-mole clean # Deep system cleanup
-mole clean --dry-run # Preview cleanup (no deletions)
-mole uninstall # Interactive app uninstaller
-mole update # Update to latest version
+mole # Interactive menu
+mole clean # System cleanup
+mole clean --dry-run # Preview mode
+mole uninstall # Uninstall apps
+mole analyze # Disk analyzer
+mole update # Update Mole
mole --help # Show help
```
-> Installed via Homebrew? Use `brew upgrade mole` to update
+> ๐ก New to terminal? Check [ๅฐ็ฝไฝฟ็จๆๅ](./GUIDE.md) ยท Homebrew users: `brew upgrade mole` to update
-## Examples
+## Features
-### Deep System Cleanup
+### ๐งน 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)
+ โ User app cache (45.2GB) # Caches, logs, trash (20-50GB)
+ โ User app logs (2.1GB)
โ Trash (12.3GB)
-โถ Browser cleanup
- โ Chrome cache (8 items) (8.4GB)
+โถ Browser cleanup # Chrome, Safari, Arc (5-15GB)
+ โ Chrome cache (8.4GB)
โ Safari cache (2.1GB)
- โ Arc cache (3.2GB)
-โถ Extended developer caches
+โถ Developer tools # npm, Docker, Xcode (15-40GB)
โ Xcode derived data (9.1GB)
- โ Node.js cache (4 items) (14.2GB)
- โ VS Code cache (1.4GB)
+ โ Node.js cache (14.2GB)
-โถ Applications
- โ JetBrains cache (3.8GB)
- โ Slack cache (2.2GB)
- โ Discord cache (1.8GB)
+โถ Others # Cloud, Office, Media (10-40GB)
+ โ Dropbox cache (5.2GB)
+ โ Spotify cache (3.1GB)
====================================================================
๐ CLEANUP COMPLETE!
๐พ Space freed: 95.50GB | Free space now: 223.5GB
-๐ Files cleaned: 6420 | Categories processed: 6
====================================================================
```
-### Smart App Uninstaller
+**Protect important files:**
+
+```bash
+# View whitelist
+mole clean --whitelist
+
+# Add protection
+echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist
+```
+
+### ๐๏ธ Smart App Uninstaller
```bash
$ mole uninstall
-Select Apps to Remove
-
+๐๏ธ 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 52 related files
+ โ Removed application # /Applications/
+ โ Cleaned 52 related files # ~/Library/ (12 locations)
+ - Support files & caches # Application Support, Caches
+ - Preferences & logs # Preferences, Logs
+ - WebKit storage & cookies # WebKit, HTTPStorages
+ - Extensions & plugins # Internet Plug-Ins, Services
+ - System files (sudo) # /Library/, Launch daemons
====================================================================
๐ UNINSTALLATION COMPLETE!
-๐๏ธ Apps uninstalled: 1 | Space freed: 12.8GB
+Space freed: 12.8GB
====================================================================
```
-## What Mole Cleans
-
-| Category | Targets | Typical Recovery |
-|----------|---------|------------------|
-| **System** | App caches, logs, trash, crash reports, Spotlight cache | 20-50GB |
-| **Browsers** | Safari, Chrome, Edge, Arc, Firefox, Brave cache | 5-15GB |
-| **Developer** | npm, pip, Docker, Homebrew, Xcode, Android Studio | 15-40GB |
-| **Cloud Storage** | Dropbox, Google Drive, OneDrive, Baidu Netdisk cache | 5-20GB |
-| **Office Apps** | Microsoft Office, iWork, WPS Office cache | 2-8GB |
-| **Media Apps** | Spotify, Music, VLC, IINA, video players cache | 3-12GB |
-| **Communication** | Slack, Discord, Teams, WeChat, Zoom cache | 3-10GB |
-| **Virtualization** | VMware, Parallels, VirtualBox, Vagrant cache | 5-15GB |
-
-**Protect Important Files:** Create `~/.config/mole/whitelist` to preserve critical caches:
+### ๐ Disk Space Analyzer
```bash
-# View current whitelist
-mole clean --whitelist
+$ mole analyze
-# Example: Protect Playwright browsers and build tools
-echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist
+๐ Analyzing: /Users/tw93
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+Total: 156.8GB
+
+โโ ๐ Library 45.2GB
+โ โโ ๐ Caches 28.4GB
+โ โโ ๐ Application Support 16.8GB
+โโ ๐ Downloads 32.6GB
+โ โโ ๐ Xcode-14.3.1.dmg 12.3GB
+โ โโ ๐ backup_2023.zip 8.6GB
+โ โโ ๐ฆ old_projects.tar.gz 5.2GB
+โโ ๐ Movies 28.9GB
+โ โโ ๐ vacation_2023.mov 15.4GB
+โ โโ ๐ screencast_raw.mp4 8.8GB
+โโ ๐ Documents 18.4GB
+โโ ๐ Desktop 12.7GB
+
+๐ก Navigate folders to find large files, press Delete key to remove
```
-## What Mole Uninstalls
-
-| Category | What Gets Removed | Locations |
-|----------|------------------|-----------|
-| **App Bundle** | Main application executable | `/Applications/` |
-| **User Data** | Support files, caches, preferences, logs, containers, saved states | `~/Library/` (12 locations) |
-| **Web Data** | WebKit storage, HTTP storage, cookies | `~/Library/WebKit/`, `~/Library/HTTPStorages/` |
-| **Extensions** | Plugins, scripts, services, frameworks, QuickLook generators | `~/Library/Internet Plug-Ins/`, `~/Library/Services/` |
-| **System** | Launch daemons, helper tools, system preferences, install receipts | `/Library/`, `/var/db/receipts/` (requires sudo) |
-
## FAQ
1. **Will Mole delete important files?** - No. Mole has built-in protection and skips system-critical files.
@@ -147,8 +153,8 @@ echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist
## Support
- โญ๏ธ **Star this repo** if Mole helped you recover disk space
-- ๐ **Report issues** via [GitHub Issues](https://github.com/tw93/mole/issues)
- ๐ฌ **Share with friends** who need to clean their Macs
+- ๐ **Report issues** via [GitHub Issues](https://github.com/tw93/mole/issues)
- ๐ฑ I have two cats, feed them canned food if you'd like
## License