Skip to content
/ Mole Public
forked from tw93/Mole

๐Ÿน Dig deep like a mole to clean you Mac. ๅƒ้ผน้ผ ไธ€ๆ ทๆทฑๅ…ฅๆŒ–ๆŽ˜ๆฅๆธ…็†ไฝ ็š„ Mac

License

Notifications You must be signed in to change notification settings

ocean-oo/Mole

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Mole

๐Ÿน Dig deep like a mole to clean your Mac.

Stars Version License Commits Twitter Telegram

Mole - 95.50GB freed

Features

  • ๐Ÿฆ 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

Quick Start

Tips:

  • On mission-critical Macs, wait for Mole to mature, safety first
  • ๅฆ‚ๆžœ่ฟ™ๅฐ Mac ๅฏนไฝ ้žๅธธ้‡่ฆ๏ผŒๅปบ่ฎฎ็ญ‰ Mole ๆ›ดๆˆ็†Ÿๆ—ถๆฅไฝฟ็”จ๏ผŒๅฎ‰ๅ…จ็ฌฌไธ€
  • I'm not very tech-savvy๏ผŸCheck ๅฐ็™ฝไฝฟ็”จๆŒ‡ๅ—

Install:

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

Or via Homebrew:

brew install tw93/tap/mole

Run:

mo                      # Interactive menu
mo clean                # System cleanup
mo clean --dry-run      # Preview mode
mo clean --whitelist    # Manage protected caches
mo uninstall            # Uninstall apps
mo analyze              # Disk analyzer
mo update               # Update Mole
mo remove               # Remove Mole from system
mo --help               # Show help
mo --version            # Show installed version
# If the command is not found, run `mole update` once to upgrade to the latest version.

Recommended start with mo clean --dry-run to preview, mo clean --whitelist to protect caches

Features in Detail

Deep System Cleanup

$ mo clean

โ–ถ System essentials
  โœ“ User app cache (45.2GB)
  โœ“ User app logs (2.1GB)
  โœ“ Trash (12.3GB)

โ–ถ Browser cleanup
  โœ“ Chrome cache (8.4GB)
  โœ“ Safari cache (2.1GB)

โ–ถ Developer tools
  โœ“ Xcode derived data (9.1GB)
  โœ“ Node.js cache (14.2GB)

โ–ถ Others
  โœ“ Dropbox cache (5.2GB)
  โœ“ Spotify cache (3.1GB)

====================================================================
๐ŸŽ‰ CLEANUP COMPLETE!
๐Ÿ’พ Space freed: 95.50GB | Free space now: 223.5GB
====================================================================

Smart App Uninstaller

$ mo 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              # /Applications/
  โœ“ Cleaned 52 related files         # ~/Library/ across 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 with sudo         # /Library/, Launch daemons

====================================================================
๐ŸŽ‰ UNINSTALLATION COMPLETE!
๐Ÿ’พ Space freed: 12.8GB
====================================================================

Disk Space Analyzer

$ mo analyze

๐Ÿ“Š Analyzing: /Users/You
โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
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

FAQ

  1. Is Mole safe? โ€“ Mole focuses on cleaning caches and logs, without touching app settings, user documents, or system files. You can run mo clean --dry-run to preview what will be removed before actually cleaning.
  2. How often should I clean? โ€“ About once a month, or whenever you notice disk space running low.
  3. Can I protect specific caches? โ€“ Yes. Run mo clean --whitelist to interactively choose which caches to keep. Some common ones like Playwright browsers and HuggingFace models are already protected by default.

Support

  • Star this repo if Mole helped you recover disk space
  • Share with friends who need to clean their Macs
  • Report issues via GitHub Issues
  • I have two cats, feed them canned food if you'd like

License

MIT License - feel free to enjoy and participate in open source.

About

๐Ÿน Dig deep like a mole to clean you Mac. ๅƒ้ผน้ผ ไธ€ๆ ทๆทฑๅ…ฅๆŒ–ๆŽ˜ๆฅๆธ…็†ไฝ ็š„ Mac

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%