# tw93/mole

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/tw93-mole).**

56,109 stars · 1,971 forks · Shell · GPL-3.0

## Links

- GitHub: https://github.com/tw93/Mole
- Homepage: https://x.com/HiTw93/status/2020078438724354190
- awesome-repositories: https://awesome-repositories.com/repository/tw93-mole.md

## Topics

`analyzer` `appcleaner` `clean` `cleaner` `cleaner-cli` `cleaner-script` `command-line` `daisydisk` `istat` `mac` `macos` `optimize` `sensei` `shell` `uninstall`

## Description

Mole is a terminal-based utility designed for comprehensive system maintenance, storage management, and real-time hardware monitoring. It provides a command-line interface for users to analyze disk usage, track system health metrics, and perform routine optimization tasks to maintain machine stability and performance.

The project distinguishes itself through a declarative configuration model that uses structured data files to define custom cleanup logic, allowing for precise control over the removal of temporary files and project artifacts. It incorporates a safety-first execution layer that wraps destructive operations in validation checks, ensuring that user intent is verified before any files are modified or deleted. This approach extends to application lifecycle management, where the tool facilitates the complete removal of software binaries along with their associated configuration files and orphaned data.

Beyond its core cleanup capabilities, the tool offers a broad suite of maintenance functions, including the clearing of system caches, the removal of redundant installer packages, and the optimization of background processes. It features a recursive file-system traversal engine to identify storage-consuming data and provides real-time visibility into hardware resources such as CPU, memory, and network status. Users can further extend the utility by integrating custom script directories to automate specific workflows directly from the command line.

## Tags

### System Administration & Monitoring

- [Disk Usage Analyzers](https://awesome-repositories.com/f/system-administration-monitoring/disk-usage-analyzers.md) — Scans file systems to identify large files and directories, providing clarity on storage consumption. ([source](https://github.com/tw93/Mole))
- [Application Uninstallers](https://awesome-repositories.com/f/system-administration-monitoring/application-uninstallers.md) — Removes applications along with associated configuration files and leftover data to ensure complete cleanup. ([source](https://github.com/tw93/Mole))
- [Cleanup Utilities](https://awesome-repositories.com/f/system-administration-monitoring/cleanup-utilities.md) — Uses structured configuration files to define and execute automated cleanup routines for temporary files and project artifacts.
- [Disk Management Utilities](https://awesome-repositories.com/f/system-administration-monitoring/disk-management-utilities.md) — Provides a command-line interface for identifying large files and reclaiming storage space on local drives.
- [Hardware Monitoring Tools](https://awesome-repositories.com/f/system-administration-monitoring/hardware-monitoring-tools.md) — Tracking system metrics and resource usage directly from the terminal to maintain visibility into machine health and performance.
- [System Performance Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-performance-monitors.md) — Queries operating system kernels and hardware interfaces to retrieve real-time performance metrics and resource utilization data for display.
- [Cache Cleaners](https://awesome-repositories.com/f/system-administration-monitoring/cache-cleaners.md) — Clears system cache directories, browser data, and temporary files to reclaim disk space. ([source](https://cdn.jsdelivr.net/gh/tw93/Mole@main/README.md))
- [System Resource Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-resource-monitors.md) — Queries operating system kernels and hardware interfaces to retrieve real-time performance metrics.
- [Disk Management Tools](https://awesome-repositories.com/f/system-administration-monitoring/disk-management-tools.md) — A disk analysis tool that identifies and removes redundant files, build artifacts, and installer packages to reclaim storage capacity.
- [File System Scanners](https://awesome-repositories.com/f/system-administration-monitoring/file-system-scanners.md) — Recursively scans directory structures to identify and categorize storage-consuming files based on system metadata.
- [System Optimizers](https://awesome-repositories.com/f/system-administration-monitoring/system-optimizers.md) — Adjusts system settings and configurations to improve responsiveness and streamline background processes. ([source](https://github.com/tw93/Mole))
- [Disk Cleanup Utilities](https://awesome-repositories.com/f/system-administration-monitoring/disk-cleanup-utilities.md) — Identifying and removing large files, redundant caches, and leftover installer packages to reclaim disk space on local machines.
- [Hardware Monitoring Utilities](https://awesome-repositories.com/f/system-administration-monitoring/hardware-monitoring-utilities.md) — A real-time diagnostic tool that tracks system metrics and hardware status directly within the terminal for improved machine visibility.

### Development Tools & Productivity

- [Build Artifact Purge Tools](https://awesome-repositories.com/f/development-tools-productivity/build-artifact-purge-tools.md) — Removes project-specific build artifacts and dependency folders to free up disk space. ([source](https://cdn.jsdelivr.net/gh/tw93/Mole@main/README.md))
- [Uninstallation Managers](https://awesome-repositories.com/f/development-tools-productivity/uninstallation-managers.md) — A utility that removes software packages along with their associated configuration files to ensure a complete and clean removal.
- [Workspace Maintenance Tools](https://awesome-repositories.com/f/development-tools-productivity/workspace-maintenance-tools.md) — A specialized automation tool that purges project-specific build artifacts and temporary dependency folders to keep local workspaces organized.
- [File System Utilities](https://awesome-repositories.com/f/development-tools-productivity/file-system-utilities.md) — Scans directory structures to identify and categorize storage-consuming files based on user-defined patterns and system metadata.
- [Terminal Maintenance Suites](https://awesome-repositories.com/f/development-tools-productivity/terminal-maintenance-suites.md) — A command-line interface for executing routine cleanup, optimization, and diagnostic tasks to maintain local machine performance and stability.
- [Command Orchestrators](https://awesome-repositories.com/f/development-tools-productivity/command-orchestrators.md) — Executes pre-defined scripts and system utilities to perform maintenance tasks directly within the command line.
- [Configuration Management Tools](https://awesome-repositories.com/f/development-tools-productivity/configuration-management-tools.md) — Uses structured data files to define target paths and removal logic for purging temporary files and redundant project artifacts.
- [Terminal Launchers](https://awesome-repositories.com/f/development-tools-productivity/terminal-launchers.md) — Detect the active terminal application automatically to run system tasks while providing an option to manually override the default choice through environment variables for specific workflows. ([source](https://cdn.jsdelivr.net/gh/tw93/Mole@main/README.md))

### Security & Cryptography

- [Execution Safety Wrappers](https://awesome-repositories.com/f/security-cryptography/execution-safety-wrappers.md) — Wraps destructive system operations in validation layers to ensure user intent is verified before modifying files.
- [Safety and Validation Layers](https://awesome-repositories.com/f/security-cryptography/safety-and-validation-layers.md) — Wraps destructive system operations in safety checks to ensure user intent is verified before modifying or deleting sensitive files.