🧹 Windows Cleaner CLI

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

---

⚡ Quick Start

npx windows-cleaner-cli

That's it! No installation needed. The CLI will:

1. 🔍 Scan your PC for cleanable files
2. 📋 Show you what was found with sizes
3. ✅ Let you select exactly what to clean
4. 🗑️ Clean the selected items safely

🎬 See It In Action

$ 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

✨ Features

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

🎯 What It Cleans

🟢 Safe (always safe to delete)

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

🟡 Moderate (generally safe)

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

🔴 Risky (use --risky flag)

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

📖 Usage

Basic Usage

# Interactive mode — scan, select, and clean
npx windows-cleaner-cli

# Include risky categories
npx windows-cleaner-cli --risky

Remove Apps

Remove applications with their preferences, caches, and support files:

npx windows-cleaner-cli uninstall

Maintenance Tasks

# 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

Other Commands

# 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 --clean

💻 Global Installation

If you use this tool frequently:

npm install -g windows-cleaner-cli
windows-cleaner-cli

🔒 Security

✅ 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.

🛠️ Development

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 production

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

💚 Support

If this tool saved you time or disk space, consider supporting the project!

Your support helps maintain and improve this tool. Thank you! 🙏

📄 License

MIT License — see LICENSE for details.

---

⚠️ Disclaimer
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