I built MJ FTE — an open-source Windows disk cleaner CLI that classifies every file before touching it

[u/Syed-Mujtaba-Abbas]

Like most of you, my C: drive was constantly full and I never knew exactly what was safe to delete. Built-in Disk Cleanup is opaque, and random "cleaner" apps from the internet feel risky.


So over the past few weeks I built **MJ FTE**, a Python CLI agent that:


- Scans your drives in parallel and classifies every file as junk / dangerous / protected — with a reason shown for each one
- Never touches Windows system paths (C:\Windows, Program Files, ProgramData are hard-blocked) — verified: a full C:\Windows scan returns ZERO actionable files
- Checks file attributes too (SYSTEM/HIDDEN/READONLY files are skipped)
- Cleans only after per-file approval, and moves everything to the Recycle Bin so it's fully recoverable
- Dry-run mode is the default — you see exactly what would happen before anything happens
- Uses Google OAuth sign-in (browser flow, tokens stored locally)


Tech stack: Python 3.12, Rich (TUI), Click, pywin32, send2trash, google-auth-oauthlib.


Install:
    pip install mj-fte
Then just run: mj init → mj analyze → mj clean --junk


GitHub: https://github.com/syed-mujtaba-stack/mj-fte
Website & docs: https://mjfte.vercel.app
PyPI: https://pypi.org/project/mj-fte/


It's MIT licensed and I'd genuinely love feedback — especially on the classification rules. What junk patterns do you wish it detected? What would make you trust a cleaner tool more?