Skip to main content

windowsweep - Documentation

windowsweep reclaims disk space on a Windows machine without putting your data at risk: package-manager and build caches, browser and app caches, Windows temp and update leftovers, stale project artefacts and more, behind one deletion chokepoint, a real dry-run and a developer mode that keeps recent work fast.

The README is the elevator pitch; this folder is the manual.

Start here​

If you want to...Read
Install it in under a minuteInstallation
Run your first cleanup safelyQuick start
Understand every guarantee before deleting anythingSafety model
Know what the developer question changesDeveloper mode

Reference​

PageWhat it covers
Sections 0-25Every section: what it touches, which flags tune it, how it behaves in dry-run and batch mode
CLI referenceEvery mode, option, exit code, environment variable and config key
ProfilesThe named bundles: dev, minimal, cache-only, system, deep, audit
Admin sections and elevationWhat needs Administrator rights, how --elevate works, the hibernation decision
Reports and logsWhat a run writes under ~\.windowsweep, the JSON schema, exports
AI integration guideThe contract for an agent or a script: --json, exit codes, guarantees

When something is off​

PageWhat it covers
TroubleshootingSymptom, cause, fix
FAQThe questions people ask first

Meta​

PageWhat it covers
AuthorWho built this, the sibling tools, how to support the work
PackagesThe dependency and manifest record (there are no dependencies)
Project statusThe live status record: every phase and sub-task with its state, the evidence behind it, and the rows only the author can close

Quick contact​

Issueshttps://github.com/aoneahsan/windowsweep/issues
AuthorAhsan Mahmood - aoneahsan@gmail.com
Support the workhttps://aoneahsan.com/payment?project-id=windowsweep&project-identifier=windowsweep

Last Updated: 2026-09-08 - tool version 1.2.0