nulcleanerlisted
Install: claude install-skill ellmos-ai/skills
# nulcleaner - Windows NUL-Datei Bereinigung
## Das Problem
Wenn in Git Bash unter Windows `/dev/null` in Befehlen verwendet wird (z.B. `> /dev/null`),
entsteht anstatt einer Umleitung ins Nichts eine echte **Datei namens `nul`** im aktuellen
Verzeichnis. Windows reserviert "NUL" als Device-Name, weshalb diese Dateien nicht normal
geloescht werden koennen.
Dieses Tool findet und loescht solche NUL-Dateien ueber den erweiterten UNC-Pfad (`\\?\`).
---
## Modi
| Modus | Beschreibung |
|-------|-------------|
| `scan` | Verzeichnis rekursiv nach NUL-Dateien durchsuchen |
| `delete` | NUL-Dateien finden und loeschen |
| `gui` | Grafische Oberflaeche mit Dateiauswahl |
---
## CLI Usage
```bash
# Nur scannen (zeigt gefundene NUL-Dateien)
python nulcleaner.py scan /pfad/zum/verzeichnis
# Scannen und loeschen
python nulcleaner.py delete /pfad/zum/verzeichnis
# GUI-Modus starten
python nulcleaner.py gui
```
---
## Headless-API (fuer Integration)
Das Tool bietet auch eine Python-API fuer headless-Betrieb:
```python
from nulcleaner import clean_nul_files_headless
result = clean_nul_files_headless("/pfad/zum/verzeichnis", verbose=True)
print(f"Gefunden: {result['found']}, Geloescht: {result['deleted']}")
```
**Rueckgabe:** `{'found': int, 'deleted': int, 'errors': list}`
---
## Technische Details
- Nutzt den erweiterten UNC-Pfad (`\\?\`) um Windows-reservierte Dateinamen zu loeschen
- Rekursiver Scan mit `os.walk()`
- GUI mit tkinter (keine externen Dependencies)
- Fun