Mole V1.7

Dig deep like a mole to clean your Mac.

Changelog

1. Touch ID support – Added request_sudo_access with Touch ID fallback and cleaner privileged action flow.
2. Better cleaning – Improved whitelist handling, progress display, and cache/orphan detection.
3. Whitelist: Supports filtering many common cleaning methods, go to mo clean --whitelist to try it
4. Loading & links – Unified spinner style, improved parallel jobs, and cleaned up analyze temp files and link hints.
5. Visual inspection – Refreshed analyze view with badge icons, faster mdfind loops, and clearer headers for large media.
6. Dry-run safety – Ensured nothing is deleted in --dry-run mode and validated whitelist entries first.
7. Uninstall protection – Added strict path checks and manual confirmation to prevent system deletions.
8. Locale fixes – Forced neutral LC_ALL/LANG, replaced spinners with ASCII, and muted debug noise.
9. Container safety – Stopped auto-removal of “orphaned” containers by default.
10. Removed a lot of emojis. I don’t like emojis very much now.
11. Mailbox index and information are not changed by default, and cache is added to the whitelist.
12. When uninstalling software, it supports sorting by time, size, name, and fuzzy search.

Learn how to use it through this main document. If you think mole is useful to you, welcome to Star

https://github.com/tw93/Mole

Mole V1.6.3

🦡 Dig deep like a mole to clean your Mac.

📝 Changelog

New Features

• Use mo instead of mole, which is shorter and more convenient
• Added Disk Space Analyzer, allowing interactive disk usage scanning and generating categorized reports
• Introduced a whitelist management tool, supporting interactive selection and review of caches detected in dry-run mode, with entries written to ~/.config/mole/whitelist

Enhancements

• Major enhancements to the cleaning/uninstall workflow: expanded default protection list, stronger safeguards for databases and system tools, and improved interactive batch uninstall
• Improved CLI experience: added run-time progress prompts and refined interface copy to make multi-step operations clearer
• Support mole remove to delete everything related to mole from the system.
• Filter and remove configuration island configuration issues

Documentation

• Updated and expanded documentation and guides, covering the Disk Space Analyzer, whitelist usage, and common FAQs

If you find it useful, please star it.

https://github.com/tw93/Mole

Mole V1.4

🦡 Dig deep like a mole to clean your Mac.

ChangeLog

1. Dry-Run Mode – Preview Before Cleaning

mole clean --dry-run  # See what will be deleted without actually removing anything

2. Whitelist Protection – Keep Important Caches, add your own patterns as needed.

mkdir -p ~/.config/mole
echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist

3. System App Uninstall – Remove Apps Requiring Sudo, you'll be prompted for password once if needed.

mole uninstall  # Now supports system apps (Docker, VMware, etc.)

4. Startup Animation - First launch shows a Mole animation.

          /\_/\
     ____/ o o \
   /~____  =o= /
  (______)__m_m)
          /   \
       __/ /\ \__
      /__/  \__\_

  Ready to dig deep...

5. Mole supports automatic check for update prompts.
6. Supplement the newbie usage documentation, see the prompts in the readme.
7. Homebrew Installation Support – Install via Homebrew for easier management.

   brew install tw93/tap/mole  # One-command install
   brew upgrade mole           # Easy updates

Use the document to see the markdown on the homepage. If you find it useful, please star it.

https://github.com/tw93/Mole

Mole V1.2

🦡 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
• ⚡️ Fast Interactive UI - Arrow-key navigation with pagination for large lists
• 🧹 Massive Space Recovery - Reclaim 100GB+ of wasted disk space

Installation

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

Usage

mole               # Interactive main menu
mole clean         # Deep system cleanup
mole uninstall     # Interactive app uninstaller
mole --help        # Show help

What Mole Cleans

What Mole Uninstalls