macOS · Windows · Linux

Mole

Tiefenreinigung, App-Deinstallation, Systemoptimierung, Festplattenanalyse und Statusüberwachung für Mac. Kostenloses Open-Source-CLI, plus native Mac-App.

English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français · Українська · Русский

💡 Dieses Repository ist das kostenlose Open-Source-CLI (mo). Lieber eine native App? Mole for Mac ist ein separater Download mit Prüfung vor dem Löschen, getesteter Restdateien-Entfernung für über 800 Apps, Wartung, Festplatten-Drill-down, Live-Status und Lüftersteuerung auf unterstützten Macs. Unter Windows ist Mole for Windows die native App. brew install mole installiert nur das CLI.

Funktionen

• All-in-One CLI-Toolkit: Vereint Workflows im Stil von CleanMyMac, AppCleaner, DaisyDisk und iStat Menus in einem Terminal-Befehl
• Tiefenreinigung: Entfernt Caches, Protokolle, Reste und verwaiste Daten, um Speicherplatz freizugeben
• Smarte App-Deinstallation: Entfernt Apps mitsamt LaunchAgents, Einstellungen und Restdateien
• Festplattenanalyse: Visualisiert den Speicherplatz mit einer interaktiven TUI, findet große Dateien und navigiert Verzeichnisse
• Systemoptimierung: Leert DNS-Caches, aktualisiert QuickLook/Icons und optimiert Systemdatenbanken
• Live-Monitoring: Zeigt CPU, Arbeitsspeicher, Festplatten-I/O, Netzwerk und Prozesse in Echtzeit

Schnellstart

Mole erfordert macOS 12 oder neuer und unterstützt sowohl Intel als auch Apple Silicon Macs. Falls Homebrew deine macOS-Version nicht mehr unterstützt, nutze stattdessen das Skript.

Installation über Homebrew

brew install mole

Oder per Skript

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

Mit einem KI-Agenten

Sag deinem Agenten:

Install Mole for me by reading https://raw.githubusercontent.com/tw93/Mole/main/llms.txt

Oder installiere den Skill selbst. Damit zeigen dir Claude Code, Codex, Cursor und andere Agents jede Bereinigung zuerst mit --dry-run, bevor etwas entfernt wird, und überlassen App-Deinstallationen und Schritte mit Administratorrechten dir. Aktualisieren mit npx skills update -g -y.

npx skills add tw93/Mole -a claude-code codex cursor -g -y

Als Host-Plugin: in Claude Code /plugin marketplace add tw93/Mole, dann /plugin install mole@mole, in Codex codex plugin marketplace add tw93/Mole, dann codex plugin add mole@mole.

Befehle

mo                           # Interaktives Menü
mo clean                     # Tiefenreinigung + Reste deinstallierter Apps
mo uninstall                 # Installierte Apps + deren Reste entfernen
mo optimize                  # Caches & Systemdienste aktualisieren
mo analyze                   # Visuelle Festplattenanalyse (oder 'mo analyse')
mo status                    # Live-Dashboard zur Systemgesundheit
mo purge                     # Build-Artefakte von Projekten bereinigen
mo installer                 # Installationsdateien finden und entfernen
mo slim                      # Intel-Code aus Universal-Apps entfernen

mo touchid                   # Touch ID für sudo konfigurieren
mo completion                # Shell-Autovervollständigung einrichten
mo update                    # Mole aktualisieren
mo update --nightly          # Auf neuesten Hauptentwicklungsstand aktualisieren (nur Skript-Installation)
mo remove                    # Mole vollständig vom System entfernen
mo --help                    # Hilfe anzeigen
mo --version                 # Installierte Version anzeigen

Sichere Vorschau (Dry Run)

mo clean --dry-run
mo uninstall --dry-run
mo optimize --dry-run
mo purge --dry-run
mo installer --dry-run
mo slim --dry-run
mo history
mo history --json

mo clean --dry-run --debug   # Vorschau + detaillierte Protokolle
mo optimize --whitelist      # Geschützte Optimierungsregeln verwalten
mo clean --whitelist         # Geschützte Cache-Pfade verwalten
mo purge --paths             # Projekt-Suchpfade konfigurieren
mo analyze /Volumes          # Nur externe Laufwerke analysieren
mo analyze /private/tmp      # Temporäre Benutzerverzeichnisse prüfen

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- 1.51.0
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- main

mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- --prefix "$HOME/.local/bin"
export PATH="$HOME/.local/bin:$PATH"

nix profile install github:tw93/mole/main#mole
nix profile upgrade mole
nix profile remove mole

Unter Windows (Windows-CLI)

iwr -useb https://raw.githubusercontent.com/tw93/Mole/windows/quick-install.ps1 | iex

Mole wird nur über Homebrew, dieses Repository und mole.fit verteilt. molemac.com, moleapp.net und molefit.com sind nicht Mole, und die Windows-App auf mole.bluecatbot.com ist ein separates Community-Projekt.

Sicherheit

Mole kann Dateien löschen. Deshalb prüft es Pfade, schützt gemeinsam genutzte und systemeigene Orte und fragt nach einer Bestätigung, wenn eine Aktion sie braucht. Kann Mole nicht belegen, dass eine Änderung sicher ist, überspringt oder verweigert es sie.

• clean, uninstall, purge, installer, slim und remove löschen Dateien, überprüfe sie also zuerst mit --dry-run und bei Bedarf mit --debug
• Führe Mole ohne sudo aus; Administratorrechte werden nur bei Bedarf für Systembereinigungen angefordert
• mo uninstall, mo analyze und mo slim verschieben Löschungen nach Bestätigung standardmäßig in den Papierkorb; clean, purge und installer löschen endgültig. mo uninstall --permanent überspringt den Papierkorb
• Bereinigungsaktivitäten werden in ~/Library/Logs/mole/operations.log protokolliert; überprüfe sie mit mo history oder deaktiviere das Logging mit MO_NO_OPLOG=1
• Schütze Caches mit mo clean --whitelist oder Wartungsaufgaben mit mo optimize --whitelist
• Lässt sich die Whitelist-Datei nicht lesen, brechen clean, purge und optimize ab, statt ohne sie weiterzulaufen

Hinweise zum Melden von Schwachstellen, Sicherheitsgrenzen und aktuelle Einschränkungen findest du in SECURITY.md und SECURITY_AUDIT.md.

Funktionsdetails

Die folgenden Beispiele sind gekürzt. Die genauen Einträge, Größen und Gründe für übersprungene Elemente hängen von deinem Mac ab.

Bereinigung (Clean)

mo clean scannt sichere Caches, Protokolle, temporäre Dateien, Entwickler-Artefakte und Reste entfernter Apps. Es leert standardmäßig ~/.Trash; um ihn zu behalten, wähle Trash in mo clean --whitelist, demselben Menü, mit dem du Caches schützt. Volume-Trashes wie /Volumes/*/.Trashes werden dabei nicht geleert. Die Auswahl wird in ~/.config/mole/whitelist gespeichert. Bevor du eigene Pfade hinzufügst, öffne das Menü und drücke Enter, um die Auswahl zu speichern, und ergänze dann einen Pfad pro Zeile. Eine vorhandene Datei ersetzt die optionalen Standardregeln; der integrierte Sicherheitsschutz gilt weiterhin.

$ mo clean

Clean Your Mac

⚙ Apple Silicon | Free space: 219.0GB

➤ User essentials
  ✓ User app cache · 18 items, 2.4GB
  ✓ User app logs · 7 items, 12.8MB
  ✓ Trash · emptied, 9 items

➤ App caches
  ✓ App Store cache · 8 items, 248.5MB

➤ Browsers
  ✓ Safari cache · 24 items, 642.1MB
  ✓ Chrome cache · 31 items, 1.2GB

➤ Developer tools
  ✓ npm cache · cleaned
  ◎ pnpm cache · skipped (pnpm busy)

======================================================================
Cleanup complete
Removed: 4.5GB · 97 items
Free space: 223.5GB (+4.5GB)
======================================================================

Deinstallation (Uninstall)

mo uninstall entfernt eine installierte App zusammen mit den zugehörigen Dateien, die Mole eindeutig dieser App zuordnen kann. Gemeinsam genutzte Dateien bleiben erhalten, solange eine andere installierte Kopie derselben App sie noch nutzt. Falls eine App bereits gelöscht wurde, findet mo clean verbliebene Reste.

Persönliche Daten wie Einstellungen und Plugins bleiben standardmäßig erhalten. Mit D in der Vorschau wählen Sie einzelne Datenpfade zum Entfernen aus. Mit mo uninstall --with-data sind diese Daten bereits ausgewählt, ausgenommen Browserprofile und App-Group-Container; die Vorschau listet sie separat, und mit D behalten Sie jeden beliebigen Pfad. Nach der Deinstallation zeigt Mole Verweise auf entfernte Pfade in Shell-, Hook- oder MCP-Konfigurationen nur als Datei und Zeilennummer an; die Konfigurationen bleiben unverändert.

$ mo uninstall

Select Apps to Remove  1/3 selected

➤ ● Photoshop 2024                4.20GB | 2mo ago
  ○ IntelliJ IDEA                 2.80GB | 3d ago
  ○ Premiere Pro                  3.40GB | 2w ago

Files to be removed:

✓ Photoshop 2024, 4.20GB
  ✓ /Applications/Adobe Photoshop 2024/Adobe Photoshop 2024.app

Personal data kept:
  ~/Library/Application Support/Adobe/Adobe Photoshop 2024
  ~/Library/Preferences/com.adobe.Photoshop.plist

D choose personal data

======================================================================
Uninstall complete
Removed 1 app, freed 4.20GB: Photoshop 2024
======================================================================

Optimierung (Optimize)

mo optimize führt begrenzte Wartungsaufgaben für unterstützte Finder-, Netzwerk-, Datenbank- und macOS-Dienste aus. Aufgaben, die nicht nötig, gerade nicht sicher oder nicht verfügbar sind, werden mit Begründung übersprungen. Mit mo optimize --whitelist schließt du Aufgaben oder Pfadmuster aus, etwa um dauerhaft gemountete Images wie /Volumes/mail vom Unmount-Vorschlag auszuschließen.

$ mo optimize

Optimize

⚙ System  18/32 GB RAM | 616/926 GB Disk | Uptime 6d

PERFORMANCE DIAGNOSIS
  ✓ No sustained high-CPU bottleneck detected

➤ Finder Cache Refresh
  ✓ QuickLook thumbnails refreshed
  ✓ Icon services cache rebuilt

➤ Network Cache Refresh
  ✓ DNS cache refreshed

➤ Database Optimization
  ◎ Close these apps before database optimization: Safari

➤ Disk Health
  ✓ Disk verify skipped

======================================================================
Optimization Complete
Applied 2 optimizations
13 unchanged | 3 skipped | 1 unavailable
======================================================================

Speicheranalyse (Analyze)

mo analyze öffnet einen interaktiven Festplatten-Explorer im Terminal. Unterstützt Pfeiltasten und Vim-Steuerung, Filterung, Mehrfachauswahl, Finder-Vorschau und sicheres Verschieben in den Papierkorb. Externe Laufwerke werden in der Standardübersicht ausgespart; prüfe sie mit mo analyze /Volumes oder einem bestimmten Mount-Pfad. Verwende mo analyze /private/tmp, um temporäre Benutzerdateien zu prüfen, ohne sie automatisch zu löschen. Bei der dateiweisen Prüfung werden APFS-Klone mit vollständig geteilten Blöcken einmal gezählt; schnelle Ordnerschätzungen können gemeinsame Blöcke weiterhin mehrfach zählen.

Ein + am Ende einer Größenangabe zeigt einen Teilscan an; unknown bedeutet, dass die Größe nicht berechnet werden konnte. Durch Timeouts unterbrochene Ergebnisse überschreiben keinen vollständigen Cache; spätere Scans ergänzen fehlende Daten. Ordner, die macOS das Terminal nicht lesen lässt, bleiben als Teilscan markiert, bis sich die Zugriffsrechte ändern. Die Terminal-Liste zeigt nur die 30 größten Einträge, daher kann ein nicht lesbarer Eintrag außerhalb der Liste liegen; die Summe zeigt trotzdem einen Teilscan an. Die JSON-Ausgabe für Verzeichnisse enthält alle gescannten Einträge.

mo analyze --json /path enthält scan_status (complete, partial oder unavailable) für das Ergebnis und jeden Eintrag. Numerische Größen enthalten gemessene Bytes; eine Null mit unavailable heißt nicht, dass das Verzeichnis leer ist. Auch Teilscans enden mit Code 0, daher sollten Skripte scan_status prüfen. Die Vollständigkeit gilt innerhalb der bestehenden Scan-Ausschlüsse von Mole und verspricht keinen atomaren Dateisystem-Snapshot.

$ mo analyze

Analyze Disk  (302.1GB free)
Select a location to explore:

 ▶  1. ████████████████████████  47.9%  |  Home                       75.4GB
    2. ███████████               22.0%  |  User Library               34.6GB
    3. ███████                   14.2%  |  Applications               22.4GB
    4. █████                     10.7%  |  System Library             16.9GB
    5. ███                        5.2%  |  Old Downloads (90d+)       8.2GB  >3mo

Systemstatus (Status)

mo status ist ein schreibgeschütztes Dashboard für Hardware, Systemauslastung, Festplattenaktivität, Netzwerkverkehr, Stromversorgung und Prozesse.

Wenn die Standard-IPv4-Route über ein VPN oder einen Tunnel läuft, erfasst die Grafikanzeige diese Schnittstelle, um doppelte Zählungen mit dem physischen Adapter zu vermeiden. Die JSON-Ausgabe behält die Raten pro Schnittstelle, einschließlich des gerouteten Tunnels; inaktive Tunnel außerhalb der Standardroute bleiben ausgeblendet.

$ mo status

Mole Status  Health ● 92  MacBook Pro · M4 Pro · 32GB · macOS 26

⚙ CPU                                    ▦ Memory
Total   ████████████░░░░░░░  45.2%       Used    ███████████░░░░░░░  58.4%
Load    0.82 / 1.05 / 1.23 (8 cores)     Total   18.7 / 32.0 GB
Core 1  ███████████████░░░░  78.3%       Free    ████████░░░░░░░░░░  41.6%
Core 2  ████████████░░░░░░░  62.1%       Avail   13.3 GB

▤ Disk                                   ⚡ Power
Used    █████████████░░░░░░  67.2%       Level   ██████████████████  100%
Free    156.3 GB                         Status  Charged
Read    ▮▯▯▯▯  2.1 MB/s                  Health  Normal · 423 cycles
Write   ▮▮▮▯▯  18.3 MB/s                 Temp    58°C · 1200 RPM

⇅ Network                                ▶ Processes
Down    ▁▁█▂▁▁▁▁▁▁▁▁▇▆▅▂  0.54 MB/s      Zombies 3 · Chrome (4242) ×3
Up      ▄▄▄▃▃▃▄▆▆▇█▁▁▁▁▁  0.02 MB/s      Code       ▮▮▮▮▯  42.1%
Proxy   HTTP · 192.168.1.100             Chrome     ▮▮▮▯▯  28.3%

Der Zustandswert fasst CPU, RAM, Festplattenkapazität, SMART-Status, I/O, Temperatur, Batterie und Uptime zusammen. Drücke k für das Kätzchen, c zum Umschalten der CPU-Kerne und q zum Beenden; Einstellungen werden gespeichert.

$ mo analyze --json ~/Documents
{
  "path": "/Users/you/Documents",
  "overview": false,
  "entries": [
    { "name": "Library", "path": "...", "size": 80939438080, "is_dir": true }
  ],
  "large_files": [
    { "name": "backup.zip", "path": "...", "size": 8796093022 }
  ],
  "total_size": 168393441280,
  "total_files": 42187
}

$ mo status --json
{
  "host": "MacBook-Pro",
  "health_score": 92,
  "cpu": { "usage": 45.2, "logical_cpu": 8 },
  "memory": { "total": 34359738368, "used": 20078972109, "used_percent": 58.4 },
  "disks": [],
  "process_collected_at": "2026-08-29T12:30:00Z",
  "process_stale": false,
  "zombie_count": 3,
  "zombie_parents": [
    { "pid": 4242, "name": "Google Chrome for Testing", "count": 3 }
  ],
  "zombie_parents_complete": true,
  "uptime": "3d 12h 45m"
}

Projektbereinigung (Purge)

mo purge findet neu erstellbare Projekt-Build-Dateien wie node_modules, target, .build, build und dist. Dateien werden nach Projekten gruppiert, und nur die bestätigten Einträge werden endgültig gelöscht, ohne Umweg über den Papierkorb. Artefakte mit Aktivität in den letzten 7 Tagen oder mit nicht prüfbarer Aktivität sind standardmäßig abgewählt. Mole nutzt fd, wenn verfügbar, und fällt sonst auf find zurück; Verzeichnisse mit Deployment-Schlüsseln, verschachtelten Git-Repositories oder getrackten Git-Dateien sind automatisch geschützt. Nicht-interaktiv erfordert mo purge --yes; nutze mo purge --dry-run zur Voransicht.

Verwende Bild auf/ab oder h/l zum Blättern, [/] zum Springen zwischen Projekten und X, um ein Projekt zu überspringen und weiterzugehen. / durchsucht Projektpfade und Artefaktnamen, n findet den nächsten Treffer, ohne die Auswahl zu ändern, und Enter öffnet die abschließende Pfadprüfung. Der angezeigte Speicherplatz ist eine Schätzung; nicht gemessene Artefakte und unvollständige Scans werden ausdrücklich gekennzeichnet.

$ mo purge

Purge Project Artifacts

Select Artifacts to Purge
6.00GB, 2 selected

➤ ● ┌ ~/Projects/website        3.80GB | node_modules | 28d
  ○ └ ~/Projects/website         186MB | dist         | <1d
  ● ┌ ~/Projects/rust-app       2.20GB | target       | 2mo
  ○ └ ~/Projects/rust-app         22MB | dist         | <7d

======================================================================
Purge complete
Estimated space freed: 6.00GB | Items: 2 | Free: 223.5GB
======================================================================

~/Documents/MyProjects
~/Work/ClientA
~/Work/ClientB

Installationsdateien (Installer)

mo installer findet DMG-, PKG-, MPKG-, ISO-, XIP- und Installer-ZIP-Dateien in Downloads, Schreibtisch, Homebrew-Caches, iCloud, Mail, Telegram und weiteren unterstützten Orten. Vor dem Löschen werden Größe und Quelle angezeigt. Scans verfügen über einen globalen Timeout-Schutz; schlägt ein Scan oder eine Metadatenabfrage fehl oder läuft ab, verwirft Mole die Liste und wählt keine Dateien aus. Beschädigte und nicht lesbare ZIP-Archive werden übersprungen, Symlinks als Scan-Wurzel werden unterstützt, Symlinks darunter aber nicht verfolgt. Vor dem endgültigen Löschen werden Dateien erneut überprüft, um sicherzustellen, dass sie sich nicht verändert haben.

$ mo installer

Select Installers to Remove, 3.83GB, 5 selected

➤ ● Photoshop_2024.dmg          1.20GB | Downloads
  ● IntelliJ_IDEA.dmg          850.6MB | Downloads
  ● Illustrator_Setup.pkg      920.4MB | Downloads
  ● PyCharm_Pro.dmg            640.5MB | Homebrew
  ● Acrobat_Reader.dmg         220.4MB | Downloads
  ○ AppCode_Legacy.zip         410.6MB | Downloads

======================================================================
Installers cleaned
Removed 5 installers, freed 3.83GB
======================================================================

Apps verschlanken (Slim)

mo slim entfernt auf Apple-Silicon-Macs den Intel-Code aus Universal-Apps. Es listet die Apps, die dir gehören und mit einer Developer ID signiert sind, samt der Größe ihres Intel-Codes, und ändert nur die Apps, die du auswählst. Jede App wird zuerst in einer Kopie verschlankt, wobei nur Hauptprogramme und verschachtelter Code mit eigener Signatur angefasst werden. Die Kopie ersetzt die App erst, wenn sie ihren Apple-Silicon-Code behält und die Codesignatur- und Gatekeeper-Prüfung besteht; das Original wandert in den Papierkorb. App-Store-Apps, Apple-Apps, Apps mit „Mit Rosetta öffnen“, Apps anderer Benutzer und laufende Apps bleiben unangetastet. Entwicklerwerkzeuge sind nicht nötig, und ein App-Update bringt den Intel-Code zurück.

Schnellstarter

curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh | bash

Community

Vielen Dank an alle Mitwirkenden, die Mole voranbringen. Folge ihnen gern ❤️

Echtes Feedback von Nutzern auf 𝕏:

Video-Anleitung bevorzugt? Sieh dir das Mole-Tutorial von PAPAYA 電腦教室 an.

Unterstützung

• Der Kauf von Mole for Mac ist die direkteste Art, die Entwicklung von Mole zu unterstützen
• Wenn dir Mole hilft, gib dem Projekt einen Stern, teile es auf X oder erstelle ein Issue/PR
• Ich habe zwei Katzen, TangYuan und Coke, und wenn Mole dir gefällt, spendiere ihnen gerne eine Dose Katzenfutter 🥩

Diese wunderbaren Unterstützer haben das bereits getan 🐱

Lizenz

Mole ist Open Source unter der GPL-3.0; siehe LICENSE. Modifizierte und weitergegebene Versionen müssen unter derselben Lizenz verbleiben. Bei einem Fork verwende bitte einen eigenständigen Namen und nenne Mole als Upstream-Quelle. Mole for Mac ist eine separate proprietäre App. Mole bleibt langfristig bestehen.