All-in-one toolkit: CCleaner, IObit Uninstaller, WinDirStat, and Task Manager combined into a single PowerShell toolkit
Deep cleaning: Scans and removes temp files, caches, and browser leftovers to reclaim gigabytes of space
Smart uninstaller: Thoroughly removes apps along with AppData, preferences, and hidden remnants
Disk insights: Visualizes usage, manages large files, and refreshes system services
Live monitoring: Real-time stats for CPU, memory, disk, and network to diagnose performance issues

Platform Support

Mole is designed for Windows 10/11. This is the native Windows version ported from the macOS original. For macOS users, please visit the main branch for the native macOS version.

Requirements

Windows 10/11
PowerShell 5.1 or later (pre-installed on Windows 10/11)
Go 1.24+ (for building TUI tools)

Quick Start

Install via PowerShell:

# Download and run installer (recommended)
iwr -Uri "https://raw.githubusercontent.com/tw93/mole/windows/install.ps1" -OutFile "$env:TEMP\mole-install.ps1"; & "$env:TEMP\mole-install.ps1" -AddToPath

# Or install with specific options
# -Branch windows for latest code, -Tag v1.17.0 for specific version
iwr -Uri "https://raw.githubusercontent.com/tw93/mole/windows/install.ps1" -OutFile "$env:TEMP\mole-install.ps1"; & "$env:TEMP\mole-install.ps1" -AddToPath -CreateShortcut

Or install manually:

# Clone the repository and checkout windows branch
git clone -b windows https://github.com/tw93/Mole.git
cd Mole

# Run the installer
.\install.ps1 -AddToPath

Run:

mole                     # Interactive menu
mole clean               # Deep cleanup
mole uninstall           # Remove apps + leftovers
mole optimize            # Refresh caches & services
mole analyze             # Visual disk explorer
mole status              # Live system health dashboard
mole purge               # Clean project build artifacts

mole -ShowHelp           # Show help
mole -Version            # Show installed version

mole clean -DryRun       # Preview the cleanup plan
mole clean -Whitelist    # Manage protected caches
mole clean -DryRun -Debug # Detailed preview with risk levels

mole optimize -DryRun    # Preview optimization actions
mole optimize -Debug     # Run with detailed operation logs
mole purge -Paths        # Configure project scan directories

Tips

Safety: Built with strict protections. Preview changes with mole clean -DryRun.
Be Careful: Although safe by design, file deletion is permanent. Please review operations carefully.
Debug Mode: Use -Debug for detailed logs (e.g., mole clean -Debug). Combine with -DryRun for comprehensive preview including risk levels and file details.
Navigation: Supports arrow keys for TUI navigation.
Configuration: Use mole clean -Whitelist to manage protected paths, mole purge -Paths to configure scan directories.

Features in Detail

Deep System Cleanup

mole clean

Scanning cache directories...

  ✓ User temp files                              12.3GB
  ✓ Browser cache (Chrome, Edge, Firefox)         8.5GB
  ✓ Developer tools (Node.js, npm, Python)       15.2GB
  ✓ Windows logs and temp files                   4.1GB
  ✓ App-specific cache (Spotify, Slack, VS Code)  6.8GB
  ✓ Recycle Bin                                    9.2GB

====================================================================
Space freed: 56.1GB | Free space now: 180.3GB
====================================================================

Smart App Uninstaller

mole uninstall

Select Apps to Remove
═══════════════════════════
▶ ☑ Adobe Photoshop 2024     (4.2GB) | Old
  ☐ IntelliJ IDEA             (2.8GB) | Recent
  ☐ Premiere Pro              (3.4GB) | Recent

Uninstalling: Adobe Photoshop 2024

  ✓ Removed application
  ✓ Cleaned 52 related files across 8 locations
    - AppData, Caches, Preferences
    - Logs, Registry entries
    - Extensions, Plugins

====================================================================
Space freed: 4.8GB
====================================================================

System Optimization

mole optimize

System: 12/32 GB RAM | 280/460 GB Disk (61%) | Uptime 6d

  ✓ Clear Windows Update cache
  ✓ Reset DNS cache
  ✓ Clean event logs and diagnostic reports
  ✓ Refresh Windows Search index
  ✓ Clear thumbnail cache
  ✓ Optimize startup programs

====================================================================
System optimization completed
====================================================================

Disk Space Analyzer

mole analyze

Analyze Disk  C:\Users\YourName\Documents  |  Total: 156.8GB

 ▶  1. ███████████████████  48.2%  |  📁 Downloads           75.4GB  >6mo
    2. ██████████░░░░░░░░░  22.1%  |  📁 Videos              34.6GB
    3. ████░░░░░░░░░░░░░░░  14.3%  |  📁 Pictures            22.4GB
    4. ███░░░░░░░░░░░░░░░░  10.8%  |  📁 Documents           16.9GB
    5. ██░░░░░░░░░░░░░░░░░   5.2%  |  📄 backup_2023.zip      8.2GB

  ↑↓←→ Navigate  |  O Open  |  F Show  |  Del Delete  |  L Large files  |  Q Quit

Live System Status

Real-time dashboard with system health score, hardware info, and performance metrics.

mole status

Mole Status  Health ● 92  Desktop PC · Intel i7 · 32GB · Windows 11

⚙ CPU                                    ▦ Memory
Total   ████████████░░░░░░░ 45.2%       Used    ███████████░░░░░░░  58.4%
Load    0.82 / 1.05 / 1.23 (8 cores)    Total   18.7 / 32.0 GB
Core 1  ███████████████░░░░  78.3%      Free    ████████░░░░░░░░░░  41.6%
Core 2  ████████████░░░░░░░  62.1%      Avail   13.3 GB

▤ Disk                                   ⚡ Power
Used    █████████████░░░░░░  67.2%      Status  AC Power
Free    156.3 GB                         Temp    58°C
Read    ▮▯▯▯▯  2.1 MB/s
Write   ▮▮▮▯▯  18.3 MB/s

⇅ Network                                ▶ Processes
Down    ▮▮▯▯▯  3.2 MB/s                 Code       ▮▮▮▮▯  42.1%
Up      ▮▯▯▯▯  0.8 MB/s                 Chrome     ▮▮▮▯▯  28.3%

Health score based on CPU, memory, disk, temperature, and I/O load. Color-coded by range.

Project Artifact Purge

Clean old build artifacts (node_modules, target, build, dist, etc.) from your projects to free up disk space.

mole purge

Select Categories to Clean - 18.5GB (8 selected)

➤ ● my-react-app      3.2GB | node_modules
  ● old-project       2.8GB | node_modules
  ● rust-app          4.1GB | target
  ● next-blog         1.9GB | node_modules
  ○ current-work      856MB | node_modules  | Recent
  ● django-api        2.3GB | venv
  ● vue-dashboard     1.7GB | node_modules
  ● backend-service   2.5GB | node_modules

Use with caution: This will permanently delete selected artifacts. Review carefully before confirming. Recent projects — less than 7 days old — are marked and unselected by default.

Custom scan paths can be configured with mole purge -Paths.

Installation Options

Manual Installation

# Install to custom location
.\install.ps1 -InstallDir C:\Tools\Mole -AddToPath

# Create Start Menu shortcut
.\install.ps1 -AddToPath -CreateShortcut

Uninstall

.\install.ps1 -Uninstall

Configuration

Mole stores its configuration in:

Config: ~\.config\mole\
Cache: ~\.cache\mole\
Whitelist: ~\.config\mole\whitelist.txt
Purge paths: ~\.config\mole\purge_paths.txt

Directory Structure

mole/ (windows branch)
├── mole.ps1          # Main CLI entry point
├── install.ps1       # Windows installer
├── Makefile          # Build automation for Go tools
├── go.mod            # Go module definition
├── go.sum            # Go dependencies
├── bin/
│   ├── clean.ps1     # Deep cleanup orchestrator
│   ├── uninstall.ps1 # Interactive app uninstaller
│   ├── optimize.ps1  # System optimization
│   ├── purge.ps1     # Project artifact cleanup
│   ├── analyze.ps1   # Disk analyzer wrapper
│   └── status.ps1    # Status monitor wrapper
├── cmd/
│   ├── analyze/      # Disk analyzer (Go TUI)
│   │   └── main.go
│   └── status/       # System status (Go TUI)
│       └── main.go
└── lib/
    ├── core/
    │   ├── base.ps1      # Core definitions and utilities
    │   ├── common.ps1    # Common functions loader
    │   ├── file_ops.ps1  # Safe file operations
    │   ├── log.ps1       # Logging functions
    │   └── ui.ps1        # Interactive UI components
    └── clean/
        ├── user.ps1      # User cleanup (temp, downloads, etc.)
        ├── caches.ps1    # Browser and app caches
        ├── dev.ps1       # Developer tool caches
        ├── apps.ps1      # Application leftovers
        └── system.ps1    # System cleanup (requires admin)

Building TUI Tools

The analyze and status commands require Go to be installed:

# From the repository root

# Build both tools
make build

# Or build individually
go build -o bin/analyze.exe ./cmd/analyze/
go build -o bin/status.exe ./cmd/status/

# The wrapper scripts will auto-build if Go is available

Support

If Mole saved you disk space, consider starring the repo or sharing it with friends.
Have ideas or fixes? Check our Contributing Guide, then open an issue or PR to help shape Mole's future.
Love Mole? Buy Tw93 an ice-cold Coke to keep the project alive and kicking! 🥤

Community Love

Mole wouldn't be possible without these amazing contributors. They've built countless features that make Mole what it is today. Go follow them! ❤️

Join thousands of users worldwide who trust Mole to keep their systems clean and optimized.

License

MIT License — feel free to enjoy and participate in open source.