Clean 100% of app remnants, developer tool caches, virtual disks, and environment PATH junk with surgical precision.
Core Modules • Quick Start • CLI Usage • Documentation • Changelog
PurgeKit is a professional-grade system uninstaller designed specifically for Power Users and Developers on Windows. Unlike standard uninstallers (like Geek Uninstaller or Revo) which often miss deep developer cache folders, environment configuration files, or local CLI runtimes, PurgeKit aims for 100% trace-free removal of software, compilers, virtual disks, and development packages.
PurgeKit is structured around five main modules:
- 🧹 Apps Manager & Bulk Silent Uninstaller: Fetch standard desktop apps and UWP Store packages, uninstall them in batch, and scan/purge leftovers in Registry & file systems.
- 🗂️ Universal Project Sweeper: Recursively scans workspace directories for heavy compile folders and dependencies (
node_modules,target,venv,.vs...) and purges them. - 🐋 WSL2 Virtual Disk Shrinker: Safely compacts bloating virtual drive files (
ext4.vhdx) using Windows DiskPart and manages dynamic auto-shrink (Sparse mode). - 🛠️ Toolchain Version Sweeper & Dev Caches: Detects and uninstalls unused/obsolete versions of Rustup compiler toolchains and Node runtimes (NVM / FNM) with safe folder purging fallbacks.
- 🖥️ PATH Environment Cleaner: Identifies and repairs broken, duplicate, or redundant path variables in Windows User & System environments.
For in-depth explanations of how each module works, see ✨ Detailed Feature Overview.
- Rust Toolchain (MSRV 1.77+)
- Node.js (v18+)
- Windows 10 / 11 (Administrator privileges required for registry & DiskPart operations)
# Clone the repository
git clone https://github.com/ThanhNguyxnOrg/PurgeKit.git
cd PurgeKit
# Install frontend dependencies
npm install
# Run the Tauri application in developer mode
npm run tauri devTo compile the production build and generate standard .msi and .exe installers:
npm run tauri buildThe installers will be generated under src-tauri/target/release/bundle/.
PurgeKit includes a standalone CLI executable for script automation and CI/CD pipelines.
# Clean an application and its remnants silently
purgekit.exe clean "AppName"
# Clean developer tool caches
purgekit.exe cache prune --all
purgekit.exe cache prune npm cargo
# Compact a WSL2 distribution disk
purgekit.exe wsl compact "Ubuntu"Detailed documents are located in the docs/ directory:
- 📥 Installation & Setup Guide - How to download, install, and run PurgeKit on Windows.
- ✨ Detailed Feature Overview - Learn how deep scanning, snapshot diffing, and WSL2 compaction work.
- 📐 Technical Architecture - Deep dive into Tauri IPC commands, Rust modules, and SQLite schemas.
- 🗂️ Universal Project Sweeper Guide - Folder presets, walkdir scan rules, and size calculation.
- 📸 System Snapshot Engine Guide - Baseline snapshotting, registry/filesystem crawls, and diff engine.
- 📡 Active Installation Tracker Guide - Live tracking using NTFS USN Journal and registry hooks.
- 🛡️ Quarantine & Backup Engine Guide - Safe registry exports (.reg), local folder quarantine, and restoration.
- 🚀 Startup Manager & Autoruns Guide - Registry Run keys, user startup folders, and disable/enable triggers.
- 📦 Global CLI Package Sweeper Guide - Global packages (npm/yarn/pnpm/pip/cargo) scan and uninstall rules.
- 🔐 Security & UAC Elevation Model - Trust manifest, TokenElevation checks, and privilege boundaries.
- ⚙️ Configuration & Settings Guide - Format of
settings.json, scan levels, and exclusions. - 🔧 Development Guide - Guidelines for setting up, writing backend commands, and adding new developer caches.
- 🚀 Automated Release Workflow (CI/CD) - GitHub Actions workflows, triggers, and automated changelog publishing.
This is the first stable release of PurgeKit for Windows.
- Implemented WSL2 Disk Shrinker: Quets registered distributions, toggles sparse drive property, and executes safe
diskpartcompaction with a live Terminal UI logs viewer. - Implemented Toolchain Version Sweeper: Detects NVM, FNM, and Rustup runtimes, calculates sizes, identifies active compiler versions, and performs clean uninstallation.
- Implemented Universal Project Sweeper: Recursively scans configured folders for heavy dependencies (
node_modules,target,venv, etc.) and batch sweeps them. - Implemented Bulk Silent Uninstaller: Decoupled registry scan, UWP package manager, and remnant cleaning with silent fallback.
- Improved Responsiveness: Fixed vertical and horizontal overflow layouts to ensure full usability in compact, windowed multitasking modes.