🐹 Open-source Mac and PC cleaner. Keep your machine clean, light, and running like new. Fast CLI, plus native Mac and Windows apps.

★ 75,160⑂ 2,706👁 153⑃ 728● 1,210▤ 105
ShellGPL-3.0Created 2025-09-23mole.fit
More from this author
Download: V1.72.0V1.72.0 ↓1.72.02026-11-14
+124
Daily
+824
Weekly
75,160
stars
2,706
forks
153
watchers
728
prs
1,210
issues
105
releases

README

macOS · Windows · Linux


  Mole
  Deep clean, uninstall, optimize, analyze disk and monitor your Mac. Free open-source CLI, plus a Mac app.
  English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français · Polski · Українська · Русский
  
  
  
  
  
  



  


 💡 This repo is the free open-source CLI (mo). Prefer a native app? Mole for Mac is a separate download with review-before-delete cleanup, tested leftovers for 800+ apps, maintenance, disk drill-downs, live status, and fan controls on supported Macs. On Windows, the native app is Mole for Windows. brew install mole installs the CLI only.

 Features

- All-in-one CLI toolkit: Combines CleanMyMac, AppCleaner, DaisyDisk, and iStat Menus style workflows in one terminal command
- Deep clean: Removes caches, logs, leftovers, and orphaned app data to reclaim disk space
- Smart uninstaller: Removes apps together with LaunchAgents, preferences, and leftovers
- Disk analyzer: Visualizes disk usage with an interactive TUI, finds large files, and navigates directories
- System maintenance: Flushes DNS, refreshes QuickLook/icons, and optimizes system databases
- Live monitoring: Shows real-time CPU, memory, disk I/O, network traffic, and process stats

 Quick Start

Mole requires macOS 12 or newer and supports both Intel and Apple Silicon Macs. If Homebrew no longer supports your macOS version, use the script install instead.

Install via Homebrew

bash
brew install mole


Or via script

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


With an AI agent

Tell your agent:

 Install Mole for me by reading https://raw.githubusercontent.com/tw93/Mole/main/llms.txt

Or install the skill yourself. With it, Claude Code, Codex, Cursor and other agents show every cleanup with --dry-run before anything is removed, and leave app uninstalls and administrator steps to you. Update with npx skills update -g -y.

bash
npx skills add tw93/Mole -a claude-code codex cursor -g -y


As a host plugin: /plugin marketplace add tw93/Mole then /plugin install mole@mole in Claude Code, codex plugin marketplace add tw93/Mole then codex plugin add mole@mole in Codex, or dsh plugin --profile  add dsh-mole in DeepSeek Harness.

Run

bash
mo                            Interactive menu
mo clean                      Deep cleanup + already-uninstalled app leftovers
mo uninstall                  Remove installed apps + their leftovers
mo optimize                   Refresh caches & services
mo analyze                    Visual disk explorer (or 'mo analyse')
mo status                     Live system health dashboard
mo purge                      Clean project build artifacts
mo installer                  Find and remove installer files
mo slim                       Remove Intel code from universal apps

mo touchid                    Configure Touch ID for sudo
mo completion                 Set up shell tab completion
mo update                     Update Mole
mo update --nightly           Update to latest unrelease

Top issues

Discussions

Latest release

V1.72.0 V1.72.0 2026-11-14

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON