Windows Storage Analyzer

The problem

When a Windows disk fills up, the pain is not only finding large files. It is separating temporary caches, application leftovers, user data, and system components without deleting something important. storage-analyzer-windows approaches this as a local, read-only storage triage workflow: scan first, classify next, and render an interactive HTML report for review.

How it works

• Scan: scan.py walks 12 target groups with the Python standard library, including temp directories, browser caches, developer caches, ProgramData, and recycle-bin-related areas. --quick provides a fast overview, while --cache avoids repeated full scans.
• Classify: The agent reads storage_scan.json and writes storage_analysis.json, sorting findings into green safe-to-clean items, yellow items needing human judgment, and red items that should be uninstalled rather than deleted.
• Report: server.py starts a local service and opens an HTML report with top directories, estimated sizes, suggested commands, and cleanup actions. Green items default to a confirmation flow that moves files to the Recycle Bin.
• Safety: Scanning is read-only, deletion commands are shown for confirmation, protected system paths are limited, and long Windows paths use the \\?\ prefix.

Limits

It is intended for Windows 10/11 local troubleshooting and requires Python 3.10+. It is not a batch production cleanup tool: permissions, file locks, OneDrive sync, and protected directories can block access. Recycle Bin sizes may not be readable by standard users, and items involving app data, VM images, or system components are better treated as diagnostic findings than automatic delete targets.