wmole

wmole

Windows System Optimization & TUI Maintenance Toolkit

Windows 10/11 Python 3.9+ Free & Open Source CLI & TUI
wmole Logo

Deep clean, optimize, and maintain Windows.

wmole is a Windows-first toolkit designed to help you deep clean system caches, purge developer artifacts, uninstall software with residual leftover sweeps, and optimize system settings securely via terminal.

Requirements: Windows 10/11 (64-bit), Python 3.9+ (or compiled standalone EXE).

Download Latest Installer View on GitHub
Clone: git clone https://github.com/palamut62/wmole.git
Install: py -m pip install -r requirements.txt && run.bat

Built with Python, PyInstaller compiler, Inno Setup compiler, and the rich library for terminal output.

  • Path-based TUI Explorer with folder navigation, large-files view, and drive picker.
  • Safe cleanup defaults with Recycle-bin first deletion, blocked protected directories, and operation logging.
  • Smart developer purge sweeps for massive artifacts (node_modules, .venv, target, dist, .next).
  • Fuzzy leftover scanner: finds filesystem and registry residual keys after application uninstall.
  • Optimize system commands: reset DNS/Winsock, trigger Storage Sense, reset Windows Update safely.
wmole banner

System Capabilities

Startup Dashboard

Launches into a live overview: disk & RAM fullness, CPU and a 0-100 health score, reclaimable-space analysis, and a history of past cleanups with total space freed. One-key quick clean from the panel.

TUI Path Explorer

Interactively explore your paths with a slash-command input, drive pickers, detailed sub-item analysis, and instant large-files listings.

Safety First Model

Deletes route to the Recycle Bin (send2trash) by default. Blocks crucial folders (Windows, Program Files, drive roots) and supports custom lists.

Developer Purge

Cleans up stale developer workspace caches instantly. Safely identifies node_modules, .venv, target, build, dist, .next, and Nuxt folders.

Residual Leftovers

Find leftover filesystem paths and Windows registry keys following app uninstallation, cleaning remnants that general uninstallers miss.

Settings Optimize

Restructure network settings, clean Windows Prefetch/Store, invoke built-in Storage Sense, and easily flush out DNS cache securely.

Live TUI Telemetry

Provides instant system status including CPU/memory counters, uptime, network I/O, disk statistics, power state, and sensor readings.

Command Input And Context Keys

Type / in the always-visible input, filter operations, and press Enter to open the selected surface:

/dashboard : Overview
/analyze : Filesystem
/clean : Safe cleanup
/purge : Dev artifacts
/uninstall : App cleanup
/status : Telemetry
/update : Update check
/delete : Selected delete
/lang : TR / EN
Up / Down : Navigate
Enter : Open folder
Space : Pick items
D : Trash delete
K : Permanent mode
G : Large files
V : Drive picker
O : Open in Explorer
C : Quick clean
S : Live status

Warnings

  • Permanent Deletes: Enabling permanent mode with K makes confirmed deletes non-recoverable.
  • System Optimizations: Registry manipulations or service resets (e.g., Windows Update reset) require Administrator execution.
  • Purge Command: Ensure you are inside developer workspace folders before running recursive purging.
Overview Issues
palamut62

Umut

Full-Stack Developer & AI Tools Enthusiast

About Me

Hi! I'm Umut — a developer passionate about building lightweight, high-performance tools that enhance local developer workspaces. wmole represents a robust Windows-first system utility to easily monitor hardware telemetry, purge project files, sweep uninstallation remains, and fine-tune critical Windows properties efficiently.

Get in Touch

Email
umutcelik6230@gmail.com
GitHub
github.com/palamut62
X (Twitter)
x.com/palamut62

About This Project

wmole is a clean, minimal Windows command-line utility compiled into a high-performance installer. It helps developers keep workspace files clean of node_modules, temp archives, setup caches, and registry leftovers securely.

MIT License • Pure Python TUI & Compiled Win32 Executable
v0.8.0 Latest Release
July 24, 2026
Download Setup v0.8.0

Developer Toolkit & Hardening

Highlights

  • wmole doctor: One-shot dev machine health report — PATH issues, tool versions, cache sizes, disk pressure.
  • Pre-commit secret guard: wmole hook install blocks commits that contain API keys or private keys.

Features

  • wmole undo: List and restore quarantined deletions from the CLI.
  • Per-project .wmolerc: Repo-local purge/keep rules with glob-based protection.
  • Ports view: Each listener now shows the project (git repo) that owns it.
  • Faster duplicate scan: blake2b with first/last-64KB pre-hash elimination.

Security

  • GUI: removed unrestricted shell permissions; sidecar is now the only allowed command.
  • GUI: strict Content-Security-Policy enabled.
  • Uninstall launcher no longer passes registry strings through a shell.
  • In-app updater gains ed25519/minisign signature verification support.
v0.7.0
July 18, 2026
Download Setup v0.7.0

Developer Security Center

Highlights

  • Git-aware protection: Deletion is blocked when a target contains modified or untracked project files.
  • Recovery vault: Safe deletions move into a 30-day quarantine with one-click restoration.

Features

  • Secret scanning: Detects common API keys, tokens, and private keys while masking sensitive values.
  • Supply-chain auditing: Runs npm, Cargo, and Python checks and builds a lockfile-based SBOM.
  • Process protection: Prevents accidental termination of IDE, Docker, and database processes.
  • Tamper-evident history: Security events are protected by an HMAC verification chain.

Technical Specs

  • Compatible with Windows 10/11 64-bit platforms.
  • The optimized Python sidecar is bundled with the signed Tauri desktop package.
  • Update downloads require the official GitHub Release URL, expected size, and SHA-256 checksum.
v0.3.2
May 25, 2026
Download Setup v0.3.2

Interactive Self-Update & Robust Downloader

Highlights

  • Interactive Update TUI Modal: Fully interactive self-update flow inside the terminal, complete with visual progress bar and automatic restart.
  • Robust Downloader Throttling: Fixed check lockouts by only writing check files upon successful stage or no-update results.

Features

  • Command Input Navigation: Type / to access all interactive operations and contextual actions from one scrollable palette.
  • Developer Workspace Purge: Fast recursive removal of target build products (node_modules, build directories, Python venv caches).
  • System Settings Optimizer: DNS flush, Storage Sense trigger, Windows Update services manager resets.
  • Fuzzy Residual Search: Identifies program remnants across appdata directories and Windows registry.
  • Status Dashboard: Live uptime tracker, CPU/RAM stats, active network counters, and hardware thermal sensors.

Technical Specs

  • Compatible with Windows 10/11 64-bit platforms.
  • Python 3.9+ runtime dependencies bundle via PyInstaller executable wrapper.
  • Secure local logging sweeps at ~/.wmole/logs/operations.log.