+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
#2001[Mac App Bug]1 comments · 2026-11-14#2011[BUG] Windows Analyze counts NTFS hard links more than once0 comments · 2026-11-15
Discussions
#2000Feature Request: Add USB-C Port Power & Cable Bottleneck Diagnostics.0 comments · 2026-11-14#1952Mail data vs cache1 comments · 2026-11-08#1928Anyone got Mole 20% promo code1 comments · 2026-11-06#1871Mole Feedback | Mole 使用反馈1 comments · 2026-10-27#1794Slim2 comments · 2026-10-21#1720Replace the cat on the status page with a mole.0 comments · 2026-10-11#1604Which Mac apps should I test next? / 想让 Mole 继续测试哪些软件?26 comments · 2026-09-22#1601Mole for a cleanup app name is so wrong1 comments · 2026-09-22