windows-cleaner-cli

KO | EN

gitlite — search

#javascript #ai #typescript #golang #go #machine-learning #linux #docker #nodejs #awesome #cli #kubernetes #security #ios

windows-cleaner-cli

(★ 77)

Free & open-source Windows cleaner CLI — remove caches, temp files, and junk from your terminal

windows-cleaner-cli 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">🧹 Windows Cleaner CLI</h1>
 
 Free & Open Source Windows cleanup tool
 
 
 Scan and remove junk files, caches, logs, and more — all from your terminal.

🍎 Also available for macOS: <a href="https://github.com/guhcostan/mac-cleaner-cli">mac-cleaner-cli</a>

---

## ⚡ Quick Start

```bash
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

```bash
# 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:

```bash
npx windows-cleaner-cli uninstall
```

### Maintenance Tasks

```bash
# 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

```bash
# 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:

```bash
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](https://github.com/guhcostan/windows-cleaner-cli/security/advisories/new).

## 🛠️ Development

```bash
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](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

windows-cleaner-cli

windows-cleaner-cli 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

windows-cleaner-cli

windows-cleaner-cli 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README