# Mole | Tw93 | Knowledge Base | Instagit 🐹 Deep clean and optimize your Mac. GitHub Stars: 42.7k Repository: https://github.com/tw93/Mole --- ## Articles ### [How Mole's Shell Scripts Are Structured: A Layered Architecture Guide](/tw93/Mole/how-are-moles-shell-scripts-structured) Explore Mole's shell script structure, a layered architecture from bin to libcore and libmanage. Understand its convention-over-configuration design and organize your own projects effectively. - Tags: architecture - Published: 2026-03-20 ### [Mole Status Command System Metrics: Complete Guide to Host Monitoring](/tw93/Mole/what-system-metrics-does-moles-status-command-provide) Discover Mole's status command system metrics. Monitor CPU GPU memory disk I/O network throughput battery health hardware specs & more via interactive UI or JSON output. Get comprehensive host monitoring. - Tags: deep-dive - Published: 2026-03-20 ### [How to Clean Installer Files with Mole: A Complete Guide](/tw93/Mole/how-to-clean-installer-files-with-mole) Easily clean installer files on macOS with Mole. Discover how the mo clean command safely removes old installer apps and data using a deep system scan. Learn more today. - Tags: how-to-guide - Published: 2026-03-20 ### [How to Use Mole's Project Artifact Purge Feature to Reclaim Disk Space](/tw93/Mole/how-to-use-moles-project-artifact-purge-feature) Learn how to use Mole's project artifact purge feature to safely delete build artifacts like node_modules and reclaim disk space with an interactive menu. - Tags: how-to-guide - Published: 2026-03-20 ### [What TUI Framework Does Mole Use? Bubble Tea Architecture Explained](/tw93/Mole/what-tui-framework-does-mole-use) Mole utilizes the Bubble Tea framework and Elm-style architecture for its TUI. Discover the Go implementation powering this interactive terminal application. - Tags: architecture - Published: 2026-03-20 ### [How to Disable Operation Logging in Mole: A Complete Guide](/tw93/Mole/how-to-disable-operation-logging-in-mole) Easily disable operation logging in Mole by setting the MO_NO_OPLOG=1 environment variable. Follow this complete guide to stop Mole from creating operation logs. - Tags: how-to-guide - Published: 2026-03-20 ### [How to Enable Debug Logging in Mole: A Complete Guide](/tw93/Mole/how-to-enable-debug-logging-in-mole) Enable debug logging in Mole easily by setting MO_DEBUG=1 or using the --debug flag. Access detailed logs at ${HOME}/Library/Logs/mole/mole_debug_session.log. - Tags: how-to-guide - Published: 2026-03-20 ### [What Go Modules Are Used in Mole? Complete Dependency Analysis](/tw93/Mole/what-are-the-go-modules-used-in-mole) Discover the five core Go modules powering Mole: Bubble Tea and Lipgloss for UI, xxhash for hashing, gopsutil for system stats, and x/sync for concurrency. Understand Mole's dependencies. - Tags: api-reference - Published: 2026-03-20 ### [Can Mole Analyze External Drives? Complete Guide to Scanning /Volumes](/tw93/Mole/can-mole-analyze-external-drives) Yes Mole analyzes external drives. Learn how to scan /Volumes with Mole by passing mount points to mo analyze, even though it skips them by default for faster startup. - Tags: how-to-guide - Published: 2026-03-20 ### [What Application Data Does Mole's Uninstaller Remove? Complete Technical Breakdown](/tw93/Mole/what-application-data-does-moles-uninstaller-remove) Mole's uninstaller removes caches preferences Application Support files LaunchAgents Dock icons and Homebrew cask artifacts. Get a complete breakdown of what Mole uninstaller removes. - Tags: deep-dive - Published: 2026-03-20 ### [How to Customize Mole's Cleanup Targets: A Complete Guide](/tw93/Mole/how-to-customize-moles-cleanup-targets) Learn how to customize Mole's cleanup targets by modifying MOLE_PURGE_TARGETS or using mo purge --paths. Take full control of what and where Mole purges. - Tags: how-to-guide - Published: 2026-03-20 ### [How Mole's Scanner Optimizes Disk Traversal for High-Performance File Analysis](/tw93/Mole/how-does-moles-scanner-optimize-disk-traversal) Discover how Mole's scanner optimizes disk traversal with CPU-aware workers, directory semaphores, and fast-path folding for high-performance file analysis and minimal memory. - Tags: performance - Published: 2026-03-20 ### [Mole Cache Expiration Policy: TTL Rules and Grace Windows Explained](/tw93/Mole/what-is-the-expiration-policy-for-moles-cache) Understand Mole's cache expiration policy. Learn about TTL rules for snapshots and directory caches, stale cache durations, and grace windows for modifications. - Tags: deep-dive - Published: 2026-03-20 ### [How Mole's Caching System Speeds Up Disk Analysis](/tw93/Mole/how-does-moles-caching-system-work-for-disk-analysis) Discover how Mole's caching system accelerates disk analysis by storing filesystem scan results in binary files, ensuring validity and avoiding redundant rescans. - Tags: internals - Published: 2026-03-20 ### [How to Configure Mole's Protected Directories: A Complete Guide to the Whitelist System](/tw93/Mole/how-to-configure-moles-protected-directories) Learn to configure Mole's protected directories using the whitelist system. Secure your files from accidental deletion by mastering this essential feature. Protect your data today. - Tags: how-to-guide - Published: 2026-03-20 ### [Mole Dry-Run Mode: How to Preview Destructive Actions Safely](/tw93/Mole/what-is-moles-dry-run-mode-and-how-to-use-it) Safely preview destructive actions with Mole's dry-run mode. Set DRY_RUN=true to see changes before files are modified or deleted. Learn how to use this essential safety feature. - Tags: how-to-guide - Published: 2026-03-20 ### [How to Monitor System Status in Real-Time with Mole](/tw93/Mole/how-to-monitor-system-status-in-real-time-with-mole) Easily monitor system status in real-time using Mole. Launch a live dashboard with `mo status` or get programmatic output with `--json` for continuous hardware and OS metric sampling. - Tags: how-to-guide - Published: 2026-03-20 ### [How to Analyze Disk Usage with Mole: Fast Concurrent Scanning on macOS](/tw93/Mole/how-to-analyze-disk-usage-with-mole) Analyze disk usage on macOS with Mole. This tool offers fast concurrent scanning, caching, and TUI or JSON output for efficient analysis and automation. - Tags: how-to-guide - Published: 2026-03-20 ### [How to Uninstall Applications with Mole: Complete Guide to the macOS Uninstaller](/tw93/Mole/how-to-uninstall-applications-with-mole) Uninstall macOS apps completely with Mole. Safely remove applications and associated files using the `mo uninstall` command for a clean system. - Tags: how-to-guide - Published: 2026-03-20 ### [How Does Mole Perform Deep System Cleaning?](/tw93/Mole/how-does-mole-perform-deep-system-cleaning) Discover how Mole performs deep system cleaning by targeting aged caches, logs, and temporary files. Learn about its secure system-level module and whitelist features. - Tags: deep-dive - Published: 2026-03-20 ### [What Commands Are Available in Mole? Complete CLI Reference](/tw93/Mole/what-commands-are-available-in-mole) Explore all 13 Mole CLI commands with this comprehensive reference. Learn how to clean, uninstall, optimize, analyze, and manage your system effectively using the `mo` wrapper. - Tags: api-reference - Published: 2026-03-20 ### [How to Install Mole on macOS: Complete Setup Guide](/tw93/Mole/how-to-install-mole-on-macos) Install Mole on macOS easily with a single Bash command. Get the complete setup guide for the latest release and add Mole to your PATH. - Tags: getting-started - Published: 2026-03-20