tw93 / Mole

macOS · Windows 
 Mole 
 Deep clean, uninstall apps, optimize, analyze disk, and monitor your Mac. Free open-source CLI, plus a native Mac app. 
 English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français · Українська · Русский 
> 💡 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**
 [code] 
**Or via script**
 [code] 
**On Windows** (Windows CLI)
 [code] 
Mole is only distributed through Homebrew, this GitHub repository, and mole.fit for the Mac and Windows apps. Sites offering a "Mole-based" app or asking you to paste an encoded command into Terminal are not affiliated with Mole. This includes `molemac.com`, `moleapp.net` and `molefit.com`, and the Windows app at `mole.bluecatbot.com` is an independent community project with the same name.
**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`.
 [code] 
As a host plugin: `/plugin marketplace add tw93/Mole` then `/plugin install mole@mole` in Claude Code, or `codex plugin marketplace add tw93/Mole` then `codex plugin add mole@mole` in Codex.
**Run**
 [code] 
**Preview safely**
 [code] 
 Other install options 
To install a specific release, pass any tag from the releases page, with or without its leading `V`. To track the development branch instead, pass `main`:
 [code] 
`main` installs unreleased code from the default branch, so expect rough edges. `latest` still works as a legacy alias for `main`; despite the name it does not install the newest stable release.
The script normally installs to `/usr/local/bin`, which may ask for an administrator password. Install into a user-owned direc