Free & Open Source Windows cleanup tool
Scan and remove junk files, caches, logs, and more — all from your terminal.
🍎 Also available for macOS: mac-cleaner-cli
npx windows-cleaner-cliThat's it! No installation needed. The CLI will:
- 🔍 Scan your PC for cleanable files
- 📋 Show you what was found with sizes
- ✅ Let you select exactly what to clean
- 🗑️ Clean the selected items safely
$ npx windows-cleaner-cli
🧹 Windows Cleaner CLI
──────────────────────────────────────────────────────
Scanning your PC for cleanable files...
Found 32.5 GB that can be cleaned:
? Select categories to clean (space to toggle, enter to confirm):
◉ 🟢 Recycle Bin 2.1 GB (45 items)
◉ 🟢 Browser Cache 1.5 GB (4 items)
◉ 🟢 Temporary Files 549.2 MB (622 items)
◉ 🟡 User Cache Files 12.5 GB (118 items)
◉ 🟡 Development Cache 15.9 GB (14 items)
Summary:
Items to delete: 803
Space to free: 32.5 GB
? Proceed with cleaning? (Y/n)
✓ Cleaning Complete!
──────────────────────────────────────────────────────
Recycle Bin ✓ 2.1 GB freed
Browser Cache ✓ 1.5 GB freed
Temporary Files ✓ 549.2 MB freed
User Cache Files ✓ 12.5 GB freed
Development Cache ✓ 15.9 GB freed
──────────────────────────────────────────────────────
🎉 Freed 32.5 GB of disk space!
Cleaned 803 items
| Feature | Description |
|---|---|
| 🚀 One Command | Just run npx windows-cleaner-cli — no complex flags |
| 🎯 Interactive | Select exactly what you want to clean with checkboxes |
| 🛡️ Safe by Default | Risky items hidden unless you use --risky |
| 🔍 Smart Scanning | Finds caches, logs, dev files, browser data, and more |
| 📱 App Remover | Remove apps and their associated files |
| 🔧 Maintenance | Flush DNS cache, run Disk Cleanup, clear caches |
| 🔒 Privacy First | 100% offline — no data ever leaves your machine |
| 📦 Minimal Dependencies | Only 5 runtime deps, all from trusted maintainers |
| Category | What it cleans |
|---|---|
recycle-bin |
Files in the Recycle Bin |
temp-files |
Temporary files in TEMP and Windows\Temp |
browser-cache |
Chrome, Edge, Firefox, Brave cache |
chocolatey |
Chocolatey/Scoop package manager cache |
docker |
Unused Docker images, containers, volumes |
| Category | What it cleans |
|---|---|
system-cache |
Application caches in AppData\Local |
system-logs |
System and application logs |
dev-cache |
npm, yarn, pip, NuGet, Gradle cache |
node-modules |
Orphaned node_modules in old projects |
windows-update |
Old Windows Update files |
prefetch |
Windows Prefetch data |
| Category | What it cleans |
|---|---|
downloads |
Downloads older than 30 days |
itunes-backups |
iPhone and iPad backup files from iTunes |
duplicates |
Duplicate files (keeps newest) |
large-files |
Files larger than 500MB |
# Interactive mode — scan, select, and clean
npx windows-cleaner-cli
# Include risky categories
npx windows-cleaner-cli --riskyRemove applications with their preferences, caches, and support files:
npx windows-cleaner-cli uninstall# Flush DNS cache
npx windows-cleaner-cli maintenance --dns
# Run Windows Disk Cleanup
npx windows-cleaner-cli maintenance --disk
# Clear thumbnail cache
npx windows-cleaner-cli maintenance --thumbnails
# Clear font cache (requires admin)
npx windows-cleaner-cli maintenance --fonts# List all available categories
npx windows-cleaner-cli categories
# Manage configuration
npx windows-cleaner-cli config --init
npx windows-cleaner-cli config --show
# Manage backups
npx windows-cleaner-cli backup --list
npx windows-cleaner-cli backup --cleanIf you use this tool frequently:
npm install -g windows-cleaner-cli
windows-cleaner-cli| ✅ Open Source | All code publicly available for audit |
| ✅ No Network | Operates 100% offline |
| ✅ Minimal Deps | Only 5 runtime dependencies |
| ✅ CI/CD | Every release tested with TypeScript, ESLint, and automated tests |
| ✅ Socket.dev | Dependencies monitored for supply chain attacks |
Found a vulnerability? Report it via GitHub Security Advisories.
git clone https://github.com/guhcostan/windows-cleaner-cli.git
cd windows-cleaner-cli
npm install
npm run dev # Run in dev mode
npm test # Run tests
npm run lint # Run linter
npm run build # Build for productionContributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
If this tool saved you time or disk space, consider supporting the project!
Your support helps maintain and improve this tool. Thank you! 🙏
MIT License — see LICENSE for details.
This tool deletes files from your system. While we've implemented safety measures, always ensure you have backups of important data.
Made with ❤️ for Windows users everywhere