About this project

Mole is a Mac-focused system management toolkit provided in two forms: a free, open-source command-line interface (CLI) tool, and a separate paid native Mac app. It supports macOS 12 and newer, running on both Intel and Apple Silicon Macs, with an experimental Windows version available in a dedicated branch. The CLI combines functionality similar to CleanMyMac, AppCleaner, DaisyDisk, and iStat Menus into a single binary. Its core features include deep cleaning to remove caches, logs, temporary files, developer artifacts, and leftover files from already uninstalled apps to free up storage; smart uninstallation that removes installed apps along with associated launch agents, preference files, and hidden remnant data while preserving shared files still used by other installed apps; a terminal-based visual disk explorer that shows storage usage by location, identifies large files, and supports moving selected items to Trash after confirmation, with support for inspecting external drives and specific directories; system optimization that runs bounded maintenance tasks for Finder, network, database, and macOS services, with dry-run previews and whitelist options to exclude specific paths or tasks; a real-time read-only dashboard displaying live stats for CPU, GPU, memory, disk activity, network traffic, power status, and running processes, plus a composite system health score; build artifact purging that scans configured project directories for rebuildable artifacts like node_modules, target, and dist folders, allowing selective deletion to free up space with support for custom scan paths; and installer cleanup that finds and removes leftover installer files (DMG, PKG, ISO, XIP, etc.) from common locations including Downloads, Desktop, Homebrew caches, iCloud, Mail, and Telegram. The tool prioritizes safety with dry-run previews for all destructive actions, path validation to protect system and shared locations, a whitelist system to protect important caches and maintenance items, and operation logs stored at ~/Library/Logs/mole/operations.log that can be reviewed via the mo history command. It also supports shell tab completion, Touch ID configuration for sudo, and quick launchers for Raycast and Alfred. Installation options include Homebrew, a one-line install script, and custom prefix installation for password-free updates. The CLI is licensed under GPL-3.0, while the native Mac app is a separate proprietary product with a license covering 2 Macs, lifetime updates, and a 14-day refund policy.