Dokumentation

Überblick

Mac-App und CLI von Mole decken ähnliche Bereinigungskategorien ab und teilen dieselben konservativen Sicherheitsregeln und Schutzlisten, haben aber nicht exakt denselben Funktionsumfang. Die CLI ist kostenlos, Open Source und GPL-3.0-lizenziert. Die Mac-App ist eine native SwiftUI-Begleiter-App für einmalig $19, mit lebenslangen Updates und ohne Abo. Sie führt Mac-Abläufe nativ aus; die CLI bietet einige zusätzliche Terminal-Befehle.

Mac-App

Installation

Laden Sie das DMG von der Startseite herunter oder installieren Sie es über Homebrew: brew install --cask mole-app.

Bereinigen (Erde)

Scannt zehn Kategorien: App-Caches, System-Caches und Logs, Entwicklerwerkzeuge (Xcode, npm, pip, Gradle), KI-Tools (ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), Browser (Chrome, Edge, Arc, Safari, Firefox), Cloud-Speicher-Clients, Design-Tools (Adobe, Figma, Sketch), Kommunikations-Apps (Slack, Discord, WeChat, Zoom) und verschiedene temporäre Dateien. Der Papierkorb wird am Ende separat aufgeführt.

Die Prüfliste ist nach Löschrelevanz sortiert: regenerierbare Caches zuerst, benutzersichtbare Daten zuletzt, Papierkorb immer ganz unten. Hardlink-bewusste Größenberechnung bedeutet, dass zwischen Tools (uv, pnpm) geteilte Dateien nicht doppelt gezählt werden. Standardmäßig wird dauerhaft gelöscht, damit die freigegebenen Bytes der Anzeige entsprechen. Ein Schalter in den Einstellungen leitet alles über den System-Papierkorb.

Standardmäßig nur zur Prüfung: Paket-Caches mit echten Wiederaufbaukosten (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) und Projektausgaben, die ohne erneuten Download von Abhängigkeiten erzeugt werden können (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). Die Mac-App bietet heruntergeladene Abhängigkeitsordner wie node_modules, Pods und venv nicht zur Bereinigung an: Ihr Wiederaufbau benötigt Netzwerkzugriff und kann den Zustand der Sperrdatei verfehlen. Prüfeinträge bleiben bis zur Bestätigung unausgewählt; die Einstellungen können die Bereinigung in den Papierkorb leiten.

Software (Mars)

Software bündelt App-Updates, Startobjektverwaltung und Deinstallationsreinigung. Die Updates-Ansicht prüft Sparkle-, Homebrew-Cask-/Formula- und Mac-App-Store-Apps, installiert unterstützte Updates direkt oder öffnet den App Store, wenn macOS diese Übergabe verlangt.

Die Startup-Ansicht listet Login Items, Launch Agents, Launch Daemons und Hintergrundobjekte. Unterstützte Einträge können deaktiviert, im Finder gezeigt oder bei Apple-verwalteten Objekten in den Systemeinstellungen geöffnet werden.

Zum Deinstallieren wählen Sie Apps aus. Mole findet Rückstände in über fünfzehn Library-Unterordnern, darunter Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State und Input Methods. Dock-Einträge werden automatisch bereinigt, und mehrdeutige oder schwach zugeordnete Rückstände bleiben sichtbar, aber zur Prüfung abgewählt.

Updates laufen so weit wie möglich in der App: Sparkle und Homebrew Cask werden direkt in Mole installiert; Mac App Store geht über CommerceKit und fällt bei Auth- oder Timeout-Fehlern auf die App-Store-App zurück; andere Apps werden geöffnet, damit ihr eigener Updater übernehmen kann. Cmd-Klick fügt Zeilen einer Multi-Uninstall-Batch hinzu, und jeder einzelne Fehlschlag bleibt zum Wiederholen in der Liste.

Root-eigene /Applications/*.app-Bundles brauchen pro Sitzung eine einzige Administrator-Bestätigung beim ersten Entfernen; spätere Entfernungen nutzen dieselbe Autorisierung bis zum Beenden von Mole. In der Startup-Ansicht schaltet Mole Login-Objekte und geprüfte LaunchAgents / LaunchDaemons direkt, wenn sie einem stabilen launchd-Dienst zugeordnet werden können; Einträge der macOS-Hintergrundverwaltung ohne klares Handle werden in den passenden Systemeinstellungs-Bereich geleitet.

Optimieren (Merkur)

Standard-Wartungsaufgaben laufen mit einem Klick. Aufgaben ohne Adminrechte laufen still; Admin-Aufgaben werden bei Bedarf hinter einer einzigen Freigabe gebündelt.

Optimize beginnt mit einem sichtbaren Reparaturdurchlauf für Dienste, die sich meist selbst erholen, etwa Dock, Wechsel der Eingabemethode, iCloud Drive Synchronisation, AirDrop, Spotlight und Mitteilungszentrale. Die tieferen Aufgaben umfassen Quick Look, Font-Cache und Launch-Services-Garbage-Collection, SQLite-Vacuum, gespeicherte App-Zustände, Quarantäne-Ereignisse, Benachrichtigungsverlauf, defekte Einstellungen, Launch Agents, Shared File Lists, verwaiste Spotlight-Regeln, Anmeldeobjekt-Prüfung und regelmäßige Wartung.

Sicherheitsregeln überspringen Aufgaben bei unsicheren Bedingungen: Font-Cache-Neuaufbau bei geöffneten Browsern. DNS- oder Netzwerk-Stack-Resets gehören nicht zur Standardwartung.

Optimize überspringt zudem geräteberührende Aufgaben, wenn ein aktives VPN, Bluetooth HID oder Audio oder ein externer Bildschirm oder Audiogerät erkannt wird; übersprungene Aufgaben listen einen Grund im Ergebnis-Panel, damit Sie sehen, was gelaufen ist.

Analysieren (Jupiter)

Eine Treemap-Darstellung Ihrer gesamten Festplatte. Navigieren Sie in jedes Verzeichnis hinein, um die Größe auf jeder Ebene zu sehen. Dichte oder ähnlich große Einträge werden zu Zusammenfassungsblöcken gebündelt, damit die Karte lesbar bleibt.

Einträge, deren Größe nicht ermittelt werden konnte (berechtigungsgeschützte Ordner, TCC-geschützte Container), werden mit einer Wiederholungsoption angezeigt, statt stillschweigend entfernt zu werden. Geschützte Navigations-Wurzelverzeichnisse (/, /Users, /Applications) können nicht in den Papierkorb verschoben werden. Scan-Ergebnisse werden 24 Stunden lang zwischengespeichert.

Ein Klick auf ein Verzeichnis in der Treemap führt hinein; die Breadcrumb-Zeile über der Karte springt zu jedem Vorgänger zurück. Die linke Liste und echte Treemap-Blöcke behalten Aktionen: im Finder öffnen oder anzeigen, und per Rechtsklick In den Papierkorb verschieben mit Bestätigung. Zusammenfassungsblöcke dienen nur der Übersicht. Die Blockfläche in der Treemap ist proportional zur Byte-Größe, sodass die größten Speicherverbraucher visuell immer am größten erscheinen.

Status (Sonne)

Das Bento-Dashboard zeigt Health Score, CPU, Speicher, GPU, Festplatten-I/O, Netzwerk, Batterie oder Temperatur sowie je nach Hardware Lüfter- oder Temperaturdaten. Jede Metrik hat eine 60-Sekunden-Minikurve, unterstützte Macs zeigen Auto-, Kühl- und Max-Lüftermodi.

Die Prozessliste darunter aktualisiert sich jede Sekunde. Klicken Sie eine Spalte zum Sortieren oder eine Zeile zum Anheften, damit sie über Aktualisierungen hinweg sichtbar bleibt.

Alle fünf Spalten (Name, PID, CPU, Power, Speicher) sortieren beim Klick; ein weiterer Klick kehrt die Richtung um. Rechtsklick auf eine Zeile für Anheften/Lösen (über Aktualisierungen und App-Neustarts hinweg erhalten), Terminate (sanftes TERM mit KILL-Fallback) und das Kopieren des ausführbaren Pfads. Die Top-Drain-Zeile der Battery-Kachel führt direkt zur Erklärungsansicht des betreffenden Prozesses.

Menüleisten-HUD

Ein optionaler Monitor in der macOS-Menüleiste. Wählen Sie Live-Messwerte, ein kompaktes Symbol oder eine kleine Läuferanimation, deren Bewegung der Systemlast folgt. Das Popover zeigt Hardware-Kacheln, Lüftersteuerung falls unterstützt, Top-Prozesse und eine Clean-Watch-Zusammenfassung.

Unten im Popover liegen die Schnellwerkzeuge: Datenschutzanzeigen für Kamera oder Mikrofon, Keep Screen On mit Dauerwahl, Clean Screen als einfarbiger Bildschirm zum Abwischen von Display und Tastatur mit optionaler Bedienungshilfen-Eingabesperre, sowie eine Eject-Taste, wenn ein externes Laufwerk oder Image ausgeworfen werden kann. Globale Tastaturkürzel öffnen Mole von überall; ohne Dock-Symbol läuft Mole als reine Menüleisten-App. Konfiguration unter Einstellungen → Menüleiste.

Datenschutz-Hinweise pro App. Wenn eine Mitteilung eine App nennt, bewegen Sie den Zeiger darüber und wählen Für diese App nicht mehr melden. Unter Einstellungen → Menüleiste → Mitteilungen → Apps ohne Datenschutz-Hinweise können Sie die App später wieder freigeben. Reine Kamera-Hinweise bleiben allgemein, weil macOS die verwendende App nicht offenlegt; deshalb bietet Mole dort keine App-Aktion an.

Der Anzeigemodus wechselt zwischen Läufer-Animation und einer Metrik-Ansicht mit zwei konfigurierbaren Zeilen. Jede Zeile kann unabhängig CPU, Speicher, Temperatur, Festplatte oder Netzwerk anzeigen. Die Läuferfigur ist rein visuell und ändert nichts an den erfassten Messwerten.

Doctor

Über die Menüleiste: Hilfe → Diagnose starten. Mole erstellt einen kurzen, schreibgeschützten Diagnosebericht über Ihr Mac-Modell, die macOS-Version, Berechtigungen, letzte Vorgänge, Displays, externe Volumes, Netzwerk, Sicherheitsstatus und die Umgebung. Nutzen Sie Bericht kopieren für eine kurze Chat-Zusammenfassung oder Terminalbefehl kopieren, um das vollständige Paket für den privaten E-Mail-Support zu erstellen.

Doctor erkennt fünf Zustände: fehlender Vollzugriff auf die Festplatte, erhöhter Speicherdruck, Festplattennutzung über 90 %, nicht beschreibbares Vorgangsprotokoll und kürzlich fehlgeschlagene Vorgänge. Jeder Zustand verlinkt auf einen Hilfeartikel mit Lösungsschritten. Siehe die Hilfeseite für Details.

Einstellungen

Einstellungen hat drei Tabs. Allgemein: Oberflächensprache, Bei Anmeldung öffnen, Dock-Symbol ausblenden, Lizenzaktivierung und Geräteverwaltung sowie Vollzugriff-Shortcut. Werkzeuge: Cache-Löschmodus und Schutzliste. Battery Care hält den internen Akku während des Mole-Betriebs zwischen 75 % und 80 %, um den Verschleiß zu verlangsamen, auf unterstützten Macs mit einer Administratorfreigabe. Menüleiste: Menüleisten-Monitor, Wechsel zwischen Läufer und Messwerten, sichtbare Metriken, Lüfterverhalten wo unterstützt und Tastaturkürzel für Menu Bar Toggle / Keep Screen On / Clean Screen. Lizenzaktivierung ist jederzeit mit Cmd + Shift + L erreichbar.

CLI

Installation

Über Homebrew: brew install mole. Per Skript: curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash. Starten Sie mo für das interaktive Menü oder einen beliebigen Unterbefehl direkt.

Gemeinsame Befehle (auch in der Mac-App)

mo clean

Tiefenreinigung über dieselben zehn Kategorien wie in der Mac-App. Unterstützt --dry-run zur Vorschau ohne Löschung, --debug für detaillierte Protokolle und --whitelist zur Verwaltung geschützter Caches. Überspringt automatisch Caches laufender Apps.

mo uninstall

Interaktive App-Auswahl mit Restesuche. Zeigt App-Größe, Bundle-ID und letztes Nutzungsdatum an. Findet dieselben über fünfzehn Restkategorien wie die Mac-App. Unterstützt --dry-run.

mo optimize

Führt die Wartungsaufgaben der CLI aus. Admin-Aufgaben fragen nach Ihrem Passwort. Die genaue Aufgabenliste kann von der Standard-Optimize-Liste der Mac-App abweichen. Mit --whitelist lassen sich bestimmte Aufgaben für künftige Läufe ausschließen.

mo analyze

Interaktive Treemap im Terminal. Navigation mit Pfeiltasten oder Vim-Tastenkürzel (h/j/k/l). Dateien direkt von der Karte löschen. Unterstützt --json-Ausgabe und benutzerdefinierte Pfade wie mo analyze /Volumes für externe Laufwerke.

mo status

Live-System-Dashboard: CPU, GPU, Speicher, Festplatten-I/O, Netzwerk, Akku, Temperaturen, Laufzeit, Gesundheitswert und Top-Prozesse mit Sparklines über sechzig Sekunden. Unterstützt --json für die Weiterleitung an andere Tools.

Nur-CLI-Befehle

mo purge

Findet alte Build-Artefakte in Projektverzeichnissen: node_modules, target, .build, build, dist, venv. Durchsucht konfigurierbare Pfade (Standard: ~/Projects, ~/GitHub, ~/dev). Projekte jünger als 7 Tage werden als „Recent“ markiert und sind standardmäßig nicht ausgewählt. Unterstützt --dry-run und --paths zur Konfiguration der Scan-Verzeichnisse.

mo installer

Findet .dmg-, .pkg- und .zip-Installationsdateien in Downloads, Schreibtisch, Homebrew-Cache, iCloud und Mail-Anhängen. Kennzeichnet jede Datei nach Quellort. Unterstützt --dry-run.

mo touchid

Aktiviert Touch ID für sudo-Befehle. Starten Sie mo touchid enable zum Konfigurieren, mo touchid disable zum Zurücksetzen. Unterstützt --dry-run.

Hilfsbefehle

mo completion

Richtet Shell-Tab-Vervollständigung für Bash und Zsh ein. Erkennt Ihre Shell automatisch und aktualisiert die entsprechende Konfigurationsdatei.

mo update

Selbst-Update auf die neueste stabile Version. Verwenden Sie --nightly für den neuesten unveröffentlichten Build vom main-Branch (nur bei Skript-Installation). Verwenden Sie --force zur Neuinstallation der aktuellen Version.

mo remove

Deinstalliert die Mole-CLI von Ihrem System, einschließlich Konfigurationsdateien und Shell-Integration. Unterstützt --dry-run.

Sicherheit

Sowohl CLI als auch Mac-App teilen dieselben Sicherheitsprinzipien:

Pfadschutz. Eine integrierte Sperrliste umfasst systemkritische Verzeichnisse, die essenzielle Struktur Ihres Benutzerverzeichnisses und alles außerhalb bekannter Cache-Speicherorte. Symbolische Links werden vor jedem Vorgang aufgelöst und validiert.

Prozesserkennung. Caches laufender Apps werden bei der Bereinigung übersprungen. Browser-Caches werden nicht angetastet, solange der Browser geöffnet ist.

Lizenzsperre. In der Mac-App funktioniert jedes destruktive Werkzeug (Bereinigen, Deinstallieren, Optimieren, Papierkorb aus Analysieren) zweimal kostenlos. Danach ist eine aktive Lizenz erforderlich. Das Scannen ist immer kostenlos.

Whitelist. Sowohl die CLI (~/.config/mole/whitelist) als auch die Mac-App ermöglichen es, bestimmte Caches oder Optimierungsaufgaben vor zukünftigen Durchläufen zu schützen.

Vorgangsprotokoll. Jede Löschung wird unter ~/Library/Logs/mole/operations.log protokolliert. Das Doctor-Overlay der Mac-App prüft den Zustand dieses Protokolls und zeigt kürzlich aufgetretene Fehler an.

Erst ansehen. Die CLI unterstützt --dry-run für jeden destruktiven Befehl. Die Mac-App zeigt die vollständige Dateiliste und Bytezahl vor jeder Aktion.

Fehlerbehebung

Die Mac-App enthält einen integrierten Doctor, der häufige Probleme erkennt. Öffnen Sie ihn über Hilfe → Diagnose starten in der Menüleiste. Für bestimmte Zustände siehe die Hilfeseite.

Für die CLI fügen Sie --debug an jeden Befehl an, um detaillierte Protokolle zu erhalten. Prüfen Sie das Vorgangsprotokoll unter ~/Library/Logs/mole/operations.log für aktuelle Aktivitäten. Falls ein Befehl ohne Meldung fehlschlägt, prüfen Sie, ob der Vollzugriff auf die Festplatte in den Systemeinstellungen gewährt ist.

Um Probleme zu melden, siehe den Abschnitt Problem melden auf der Hilfeseite.