Skip to content

Commit 173ded5

Browse files
committed
feat: Add Windows PowerShell support
Add dev-cleaner.ps1 for Windows developers with full feature parity: - 13 cleanup options including Visual Studio, NuGet, and Windows Temp - Custom directory support via -FlutterDir and -VsDir parameters - Environment variable support (FLUTTER_SEARCH_DIR, VS_SEARCH_DIR) - Admin elevation with UAC self-relaunch - Error tracking with detailed failure summary - Browser cache cleanup (Chrome, Edge, Firefox, Brave, Opera) - App cache cleanup (Slack, Teams, Discord, Spotify, WhatsApp) Also updates README.md with Windows installation instructions and adds .gitignore for .claude/ and docs/ directories. Closes #26
1 parent 2126a64 commit 173ded5

3 files changed

Lines changed: 908 additions & 5 deletions

File tree

.gitignore

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
# Claude Code
2+
.claude/
3+
4+
# Documentation plans (internal)
5+
docs/
6+
7+
# macOS
8+
.DS_Store
9+
10+
# Windows
11+
Thumbs.db
12+
desktop.ini

README.md

Lines changed: 66 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,23 +13,23 @@
1313
<img src="./images/poster_1.0.0.png" alt="poster_1.0.0" style="width:100%; height:auto; style="border-radius: 8px;"/><br>
1414
</p>
1515

16-
## Support Latest macOS/Linux Dev Environments
16+
## Support Latest macOS/Linux/Windows Dev Environments
1717

18-
This tool is for **educational purposes**, focusing on safely removing development-related junk files (Xcode, Flutter, npm, etc.) to free up disk space.
18+
This tool is for **educational purposes**, focusing on safely removing development-related junk files (Xcode, Flutter, Visual Studio, npm, etc.) to free up disk space.
1919

2020
---
2121

2222
### ✨ Features
2323

24-
* **One-Click Cleanup:** Clear Xcode, Flutter, Gradle, npm, Homebrew, IDE, and browser caches.
24+
* **One-Click Cleanup:** Clear Xcode, Flutter, Visual Studio, Gradle, npm, NuGet, IDE, and browser caches.
2525
* **Comprehensive Flutter Cleanup:** Recursively finds and cleans all Flutter projects, removing:
2626
* FVM SDK caches and configurations (`.fvm`, `.fvmrc`)
2727
* Flutter build artifacts (`build`, `.dart_tool`, `.packages`, `pubspec.lock`)
2828
* Android Gradle caches (`android/.gradle`, `android/build`, `android/app/build`)
2929
* iOS CocoaPods caches (`ios/Pods`, `ios/Podfile.lock`, `ios/.symlinks`, Flutter frameworks)
3030
* Global Flutter cache
3131
* **Interactive Menu:** Allows selection of specific cleanup targets (e.g., Xcode only).
32-
* **Multi-platform Support:** Supports **macOS** and **Linux** (shell script).
32+
* **Multi-platform Support:** Supports **macOS**, **Linux**, and **Windows**.
3333

3434
---
3535

@@ -39,7 +39,7 @@ This tool is for **educational purposes**, focusing on safely removing developme
3939
| :--------------- | :----------- | :-------- |
4040
| macOS | Intel, Apple Silicon ||
4141
| Linux | x64, ARM64 ||
42-
| Windows | N/A | ❌ (PowerShell script pending) |
42+
| Windows | x64, ARM64 | |
4343

4444
---
4545

@@ -89,6 +89,67 @@ brew uninstall dev-cleaner
8989
brew untap jemishavasoya/dev-cleaner
9090
```
9191

92+
#### 🪟 Windows Installation
93+
94+
**PowerShell (Run as Administrator)**
95+
96+
##### One-Line Download & Run
97+
98+
```powershell
99+
irm https://raw.githubusercontent.com/jemishavasoya/dev-cleaner/main/dev-cleaner.ps1 -OutFile dev-cleaner.ps1; .\dev-cleaner.ps1
100+
```
101+
102+
> **Note:** You may need to set the execution policy first:
103+
> ```powershell
104+
> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
105+
> ```
106+
107+
##### Manual Download
108+
109+
1. Download `dev-cleaner.ps1` from this repository
110+
2. Right-click the file → **Run with PowerShell**, or
111+
3. Open PowerShell as Administrator and run:
112+
```powershell
113+
.\dev-cleaner.ps1
114+
```
115+
116+
##### Command-Line Options
117+
118+
```powershell
119+
# Show help
120+
.\dev-cleaner.ps1 -Help
121+
122+
# Show version
123+
.\dev-cleaner.ps1 -Version
124+
125+
# Custom Flutter projects directory
126+
.\dev-cleaner.ps1 -FlutterDir "C:\Projects\Flutter"
127+
128+
# Custom Visual Studio projects directory
129+
.\dev-cleaner.ps1 -VsDir "C:\Projects\DotNet"
130+
131+
# Both custom directories
132+
.\dev-cleaner.ps1 -FlutterDir "D:\Flutter" -VsDir "D:\VisualStudio"
133+
```
134+
135+
##### Environment Variables
136+
137+
```powershell
138+
# Set in your PowerShell profile for persistence
139+
$env:FLUTTER_SEARCH_DIR = "C:\Projects\Flutter"
140+
$env:VS_SEARCH_DIR = "C:\Projects\DotNet"
141+
```
142+
143+
##### Windows-Specific Cleanup
144+
145+
The Windows version includes all cross-platform cleanups plus:
146+
147+
- **Visual Studio:** Cleans `bin/`, `obj/`, `.vs/` folders from all .NET projects, plus global VS caches (ComponentModelCache, MEFCacheData)
148+
- **NuGet:** Clears global packages cache (`~/.nuget/packages`), HTTP cache, and temp files
149+
- **Windows Temp:** Clears user and system temp folders, plus Recycle Bin
150+
151+
> **Note:** Some operations require Administrator privileges. The script will automatically request elevation if needed.
152+
92153
#### 🧹 Flutter Cleanup Details
93154

94155
The Flutter cleanup option (Option 4) performs a comprehensive recursive cleanup of all Flutter projects starting from the current directory. It:

0 commit comments

Comments
 (0)