Documentatie

Overzicht

Mole heeft twee interfaces met vergelijkbare opschooncategorieën en dezelfde voorzichtige veiligheidsregels en beschermingslijsten, maar hun mogelijkheden zijn niet identiek. De CLI is gratis, open source en onder de GPL-3.0 gelicentieerd. De Mac-app is een native SwiftUI-begeleider met een eenmalige licentie van $19, gratis updates en geen abonnement. Hij biedt een grafische interface voor opschonen en Mac-onderhoud; de CLI voegt een paar commando's toe die alleen in de terminal bestaan.

Mac-app

Installatie

Download het DMG van de startpagina, of installeer via Homebrew: brew install --cask mole-app.

Opschonen (aarde)

Opschonen begint met appcaches, waaronder caches van browsers en cloudclients en applogbestanden; ontwikkelaars-, AI-, communicatie- en ontwerptools hebben hun eigen groepen. Daarna volgen restbestanden van verwijderde apps, en dan Systeemgegevens: lokale Time Machine-snapshots, systeemcaches en logbestanden, oude macOS-installatieprogramma's en verouderde downloads van bureaubladachtergronden. De prullenmand komt als laatste. De groep Apart beheren toont back-ups, lokale iCloud-bestanden, virtuele machines en modellen, buiten het opschoontotaal.

Controleer de rijen voordat je opschoont. Systeemgegevens is een opslagindeling van macOS, geen map en geen doelgrootte: de bestanden die Mole meet, komen niet overeen met het getal in de opslaginstellingen. Het meten houdt rekening met hardlinks, zodat gedeelde bestanden niet twee keer tellen. Caches worden standaard definitief verwijderd, met een optie voor de prullenmand in Instellingen; het vrijgeven van lokale snapshots verwijdert die lokale herstelpunten, niet de back-ups op een externe schijf. De optionele opschoning van het geünificeerde systeemlog is onomkeerbaar en vraagt een eigen controle.

Standaard alleen ter controle: pakketcaches met echte herbouwkosten (npm, yarn, pnpm, bun, CocoaPods, Gradle) en gegenereerde projectuitvoer die opnieuw kan worden gebouwd zonder afhankelijkheden te downloaden (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). Gedownloade mappen met afhankelijkheden zoals node_modules, Pods en venv biedt de Mac-app niet aan: ze opnieuw bouwen heeft netwerktoegang nodig en hoeft de toestand van het lockbestand niet te reproduceren. Onderdelen die alleen ter controle zijn, blijven niet geselecteerd tot je bevestigt; Instellingen kan de opschoning via de prullenmand laten lopen.

Een aparte actie onder Apart beheren kan ongebruikte ruimte terughalen in een ondersteunde virtuele schijf van Parallels, via het eigen hulpmiddel van Parallels. Zet de VM eerst normaal af; onderbroken of draaiende VM's komen niet in aanmerking. Controleer de schatting en bevestig apart. De actie bewaart de VM en de bestanden, doet niet mee aan de bulkopschoning en moet zonder onderbreking afronden.

AI-opschoning en -onderhoud (de maan)

Wanneer deze Mac gegevens van AI-tools bevat, verschijnt rechtsboven op de pagina Opschonen een verre maan die naar AI-opschoning en -onderhoud leidt. De ingang verschijnt alleen wanneer die gegevens zijn gevonden, de controle kijkt alleen naar een paar vaste mappen en loopt nooit de schijf af, en Instellingen › Algemeen › Opschonen kan hem verbergen. De pagina scant niet bij aankomst; Scan AI-gegevens start de scan, en een scan die iets vindt, opent de resultaten direct.

De resultaten staan in drie banden, naar hoeveel een verwijdering pijn kan doen. Caches en oude versies beginnen geselecteerd: vervangen builds van de opdrachtregeltools Claude Code, Codex, Cursor Agent, Grok en GitHub Copilot, inclusief de cursor-agent-releases die de desktopapp van Cursor voor zichzelf bewaart, en caches van Claude, Codex, Cursor en Grok. Sessies en worktrees beginnen niet geselecteerd: sessies van Codex, Claude Code, OpenCode en Devin voorbij een bewaartermijn die je per tool instelt (15, 30, 90 of 120 dagen, of Niet tonen, de standaard, waarbij geen sessie wordt vermeld en de rij toont hoeveel sessies de tool bewaart en hoe groot die zijn, terwijl elke keuze toont wat die zou vermelden), sessies van Claude Code voorbij die termijn waarvan de projectmap weg is, afbeeldingen die Codex heeft gemaakt voor sessies die het al heeft verwijderd, en worktrees waarvan git kan aantonen dat er geen unieke wijzigingen zijn of commits die door geen enkele branch worden bewaard. Ongebruikte tools en onderhoud beginnen niet geselecteerd: AI-opdrachtregeltools die 30 dagen niet zijn gebruikt en niet draaien, verwijderd met hun sessies en instellingen, het comprimeren van SQLite-opslag groter dan 200 MB, en configuratiemappen die al verwijderde tools hebben achtergelaten. Oude versies, caches, sessies en worktrees kun je per onderdeel deselecteren.

Sessies die in de laatste 24 uur zijn gebruikt, worden nooit vermeld, zodat de pagina werkt terwijl Codex en Claude Code openstaan. Gegevens die een draaiende tool openhoudt, blijven vermeld als in gebruik en kunnen niet worden geselecteerd, en elke rij wordt vlak voordat hij wordt verplaatst opnieuw gecontroleerd. Bestanden gaan naar de prullenmand; een Codex-sessie wordt naar de prullenmand gekopieerd en daarna verwijderd met de eigen opdracht van Codex, en de afbeeldingen die Codex ervoor heeft gemaakt gaan mee naar de prullenmand; tools die via Homebrew zijn geïnstalleerd, worden via brew verwijderd; comprimeren gebeurt ter plaatse. Herinneringen, plannen en skills staan op geen enkele rij, en van lokale modellen verschijnen alleen die van Ollama, een maand niet gebruikt en verwijderd met de eigen ollama rm.

Apps (Mars)

Apps combineert app-updates, het beheer van opstartonderdelen en het opruimen bij verwijderen. De weergave Updates controleert apps van Sparkle, Homebrew Cask en Formula, en de Mac App Store, en installeert ondersteunde updates ter plaatse of opent de App Store wanneer macOS die overdracht vereist.

De weergave Opstarten toont inlogonderdelen, Launch Agents, Launch Daemons en achtergrondonderdelen. Je kunt ondersteunde onderdelen uitschakelen, hun bestanden tonen, of naar Systeeminstellingen springen voor onderdelen die Apple beheert.

Kies voor verwijderen de apps die weg moeten. Mole vindt restbestanden in meer dan vijftien submappen van Library, waaronder Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State en Input Methods. Dock-onderdelen worden automatisch opgeschoond, en dubbelzinnige of zwak gekoppelde restbestanden blijven zichtbaar maar niet geselecteerd, ter controle. Met Cmd-klik voeg je rijen toe aan een reeks om meerdere apps te verwijderen, en een mislukking per app blijft in de lijst staan om opnieuw te proberen.

Updates verlopen waar mogelijk in de app: installaties via Sparkle en Homebrew Cask draaien in Mole; updates uit de Mac App Store gaan via CommerceKit en vallen terug op de App Store-app bij problemen met autorisatie of een time-out; andere apps worden geopend zodat hun eigen updater het kan overnemen.

Bundles /Applications/*.app die van root zijn, vragen bij de eerste verwijdering in een sessie één keer om bevestiging van een beheerder; latere verwijderingen hergebruiken dezelfde autorisatie tot je Mole stopt. De weergave Opstarten schakelt inlogonderdelen en gecontroleerde LaunchAgents / LaunchDaemons direct wanneer die aan een stabiele launchd-dienst kunnen worden gekoppeld; onderdelen die macOS via achtergrondtaken beheert en die Mole niet direct kan bedienen, gaan naar het bijpassende paneel in Systeeminstellingen.

Adobe Genuine Service heeft een actie voor het officiële verwijderprogramma. Mole opent het geïnstalleerde verwijderprogramma van Adobe wanneer het dat kan verifiëren, of biedt de instructies van Adobe aan wanneer dat niet kan. Daarna controleert het de service opnieuw; alleen het openen van het verwijderprogramma bewijst de verwijdering niet.

Optimaliseren (Mercurius)

De standaard onderhoudstaken draaien met één klik. Taken zonder beheerder draaien stil; beheerdertaken worden wanneer nodig gebundeld achter één vraag.

Optimaliseren begint met een zichtbare herstelronde voor het wisselen van invoermethode, Spotlight, Berichtencentrum en Universeel klembord. Diepere taken zijn: Quick Look opnieuw opbouwen; SQLite-opslag vacuümen; bewaarde appstatus, quarantainegebeurtenissen en meldingsgeschiedenis opschonen; kapotte voorkeuren, gedeelde bestandslijsten en verweesde Spotlight-regels herstellen; inlogonderdelen controleren; Launch Agents waarvan het programma ontbreekt naar de prullenmand verplaatsen; en periodiek onderhoud uitvoeren.

Veiligheidsdrempels slaan taken over wanneer de omstandigheden onveilig zijn. Het resetten van DNS en de netwerkstack hoort niet bij de standaard onderhoudsset.

Optimaliseren slaat een taak over wanneer de eigen controle zegt dat die niet nodig is, zoals het legen van geheugen terwijl de geheugendruk gezond is, of het comprimeren van de databases van Mail en Berichten terwijl die apps draaien; overgeslagen taken noemen een reden in het resultaatpaneel, zodat je ziet wat er is uitgevoerd. Klik op de samenvattingsregel onder Onderhoud voltooid om Optimalisatiedetails te openen, met wat er is uitgevoerd, wat is overgeslagen en waarom.

Analyse (Jupiter)

Een treemap van je hele schijf. Duik in elke map om de grootte op elk niveau te zien, waarbij dichte of vergelijkbare onderdelen worden samengevouwen in overzichtsblokken zodat de kaart leesbaar blijft.

Onderdelen die niet konden worden gemeten (mappen met beperkte rechten, containers achter TCC) verschijnen met een optie om opnieuw te proberen, in plaats van stil te verdwijnen. Beschermde navigatiewortels (/, /Users, /Applications) kunnen niet naar de prullenmand. Scanresultaten van de schijf worden bewaard, dus bij opnieuw openen zie je het laatste resultaat, en na 6 uur meet Mole op de achtergrond opnieuw.

Klik één keer op een map in de treemap om naar binnen te gaan; de padbalk boven de kaart springt terug naar elke voorouder. De lijst links en de echte treemapblokken houden allebei acties bij het onderdeel: openen of tonen in de Finder, en klikken met de rechtermuisknop voor Verplaats naar prullenmand, wat het onderdeel meteen verplaatst, zoals de Finder, zodat je het kunt terugzetten; alleen onderdelen die al in de prullenmand liggen, vragen eerst, omdat verwijderen dan definitief is. Overzichtsblokken zijn alleen een overzicht. Het oppervlak van een blok in de treemap is evenredig met de grootte in bytes, dus de grootste onderdelen tekenen altijd de grootste blokken.

Het contextmenu kopieert ook een pad van een bestand of map, zodat je het in de Finder of in een supportbericht kunt plakken zonder het onderdeel te verwijderen.

Status (zon)

Het overzicht toont Gezondheid, CPU, GPU, Geheugen, Batterij, Schijf, Netwerk en Ventilatoren. Een Mac zonder batterij toont Thermisch in plaats van Batterij, en een Mac zonder ventilatoren toont Thermisch in plaats van Ventilatoren. Trendgrafieken tonen recente activiteit, en ondersteunde Macs bieden ventilatorbediening voor de modi Auto, Koel en Max.

De proceslijst onder het raster vernieuwt elke seconde. Alle vijf kolommen (Naam, PID, CPU, Vermogen, Geheugen) sorteren bij een klik; klik opnieuw om de richting om te draaien. Klik op een rij om het uitlegpaneel te openen. Klik met de rechtermuisknop op een rij voor Zet rij vast/Maak rij los (vastgezette processen blijven bovenaan bij vernieuwen en bij het opnieuw starten van de app, zodat je één app kunt volgen zonder hem in het scrollen kwijt te raken), Beëindig (een gewoon verzoek om te stoppen, gevolgd door Forceer stop als dat nodig is) en Kopieer het pad van het uitvoerbare bestand. De rij met het hoogste verbruik bovenaan de tegel Batterij linkt direct naar dat proces in het uitlegpaneel.

Menubalkpaneel

Een optionele monitor die altijd aan staat in de menubalk van macOS. Toon het symbool, een kleine loper waarvan de beweging de systeembelasting volgt, live gegevens, of beide. Kies uit Mole, RunCat, Beagle, Poodle, Dinosaur, Horse, Rabbit, Frog, Chicken, Rubber Duck, Fishman, Pixel of Flex. De popover toont een Gezondheid-blok (score, chip, geheugen, macOS, uptime), hardwaretegels, ventilatorbediening waar die wordt ondersteund, de vijf processen met de meeste CPU, en een overzicht Totaal van wat Mole heeft opgeschoond, verwijderd en geoptimaliseerd.

Snelle hulpmiddelen staan onderaan de popover: indicatoren voor privacysignalen lichten op wanneer de camera of de microfoon in gebruik is, Wakker houden heeft een duurmenu (1, 2, 4, 8 of 12 uur, of Tot je stopt), Scherm schoonmaken maakt van het scherm een effen kleur zodat je het beeldscherm en het toetsenbord kunt afnemen, met een optioneel invoerslot dat het macOS-toegangsrecht Toegankelijkheid vraagt, en een knop Werp uit verschijnt daar wanneer een externe schijf of schijfkopie kan worden ontkoppeld. Een aanpasbare globale toetscombinatie roept Mole overal op, en Verberg Dock-symbool houdt Mole alleen in de menubalk terwijl het op de achtergrond draait. Stel alles in onder Instellingen › Menubalk.

Privacymeldingen per app. Wanneer een melding een app noemt, houd je de aanwijzer op de macOS-melding en kies je Meld niet meer voor deze app. Zet het later terug onder Instellingen › Menubalk › Meldingen › Apps met uitgeschakelde meldingen. Een melding die alleen de camera betreft, blijft algemeen, omdat macOS de app die hem bezit niet toont, dus Mole biedt op die melding geen actie per app.

De inhoud van de menubalk kiest Symbool (de loper), Live gegevens met maximaal drie instelbare meetwaarden, of Symbool en gegevens. Standaard zijn twee meetwaarden zichtbaar, en Derde statuswaarde voegt er één toe. Elke meetwaarde toont één van CPU-gebruik, Geheugengebruik, Geheugendruk, Swapgebruik, GPU-gebruik, Gebruikte schijfruimte, Chiptemperatuur, Batterijniveau, Stroomverbruik, Ventilatorsnelheid of Accessoirebatterij, en geen twee kunnen dezelfde meetwaarde dragen. Toon live netwerksnelheid is een aparte schakelaar die upload en download naast die meetwaarden zet. De keuze van de loper is puur visueel en verandert nooit welke meetwaarden worden bemonsterd. Indeling van gegevens zet de meetwaarden in Kolommen (de standaard) of Gestapeld in een compacte band van twee regels, en Draai richting om laat de loper van links naar rechts lopen.

De animatie van een loper kan worden gepauzeerd zonder een ander figuur te kiezen. Het native menu Hulpmiddelen toont Scherm aan houden, Scherm schoonmaken, ventilatorbediening op ondersteunde Macs en Wifi met lage latentie. Optionele sneltoetsen openen het hoofdvenster of schakelen ventilatorkoeling. Wifi met lage latentie staat ook op de netwerkkaarten; het pauzeert tijdelijk AWDL en AirDrop, en herstelt de vorige toestand bij uitzetten, sluimerstand, stoppen of een netwerkwijziging. Het belooft geen snellere downloads.

Diagnose

Klik in de app linksboven in het venster op het Mole-logo en kies Voer diagnose uit. Mole verzamelt een kort diagnostisch rapport dat niets wijzigt, over je Mac-model, de macOS-versie, toegangsrechten, recente bewerkingen, beeldscherm, externe volumes, netwerk, beveiligingsstatus en de omgeving. Klik op Kopieer rapport en plak het in je bericht aan support.

Diagnose controleert zeven situaties: ontbrekende Volledige schijftoegang, hoge geheugendruk, een bijna volle schijf, lage batterijconditie, een aanbevolen herstart, een bewerkingslog dat niet kan worden geschreven, en recente mislukte bewerkingen. Elke situatie linkt naar een helpartikel met stappen om het op te lossen. Zie de helppagina voor details over elk.

Instellingen

Instellingen heeft drie tabbladen. Algemeen bevat Taal (geldt na een herstart), voorkeuren voor Opschonen, Uitgesloten van opschonen, licentieactivering en apparaatbeheer, Ontvang bèta-updates, en een snelkoppeling naar Schijftoegang. Opschonen omvat Caches verwijderen (Definitief verwijderen, de standaard, of Naar prullenmand), Toon AI-opschoning en -onderhoud, Verwijder gegevens en instellingen met apps, en Snel verwijderen. Tools bevat Scherm aan houden, Scherm schoonmaken, hun toetscombinaties en Toegankelijkheid voor Scherm schoonmaken (die het macOS-toegangsrecht Toegankelijkheid nodig heeft), plus Bescherming bij opladen en ventilatorbediening op ondersteunde Macs. Bescherming bij opladen houdt de ingebouwde batterij tussen 75% en 80% terwijl Mole draait, met één toestemming van een beheerder; Ventilatorboost stoppen na afkoelen bepaalt of Koel en Max de regie teruggeven aan macOS zodra de Mac is afgekoeld. Menubalk bevat Open bij inloggen, Verberg Dock-symbool, het uiterlijk van symbool en loper, zichtbare meetwaarden en Toon live netwerksnelheid, de toetscombinatie voor het menubalkpaneel, en meldingen waaronder Meldingen voor camera en microfoon. Licentieactivering is ook bereikbaar met Cmd + Shift + L.

Terminalopties

Een paar opties die alleen sommige mensen nodig hebben, staan niet in Instellingen. Voer het commando uit in Terminal, stop Mole daarna en open het opnieuw. Om temperaturen in Fahrenheit te tonen, voer je defaults write com.tw93.MoleApp temperatureUnitPreference -string fahrenheit uit; om terug te gaan naar Celsius, voer je defaults delete com.tw93.MoleApp temperatureUnitPreference uit. Alleen de getoonde getallen veranderen; ventilatorkrommen en waarschuwingen werken nog steeds vanuit dezelfde metingen.

CLI

Installatie

Installeer met Homebrew: brew install mole. Voer mo uit voor het interactieve menu, of een subcommando direct.

Gedeelde commando's (ook in de Mac-app)

mo clean

Grondige opschoning van caches en tijdelijke bestanden. Ondersteunt --dry-run om te bekijken zonder te verwijderen, --debug voor uitgebreide logs, en --whitelist om beschermde caches te beheren. Slaat caches van draaiende apps automatisch over.

mo uninstall

Interactieve appkeuze met detectie van restbestanden. Toont de appgrootte, de bundle ID en de datum van laatste gebruik. Vindt dezelfde meer dan vijftien restcategorieën als de Mac-app. Ondersteunt --dry-run.

mo optimize

Voert onderhoudstaken van de CLI uit, met beheerdervragen wanneer dat nodig is. De precieze takenreeks kan afwijken van de standaardlijst van Optimaliseren in de Mac-app. Gebruik --whitelist om specifieke taken uit te sluiten van latere rondes.

mo analyze

Interactieve treemap in de terminal. Navigeer met de pijltoetsen of Vim-bindingen (h/j/k/l). Verplaats bestanden direct vanaf de kaart naar de prullenmand. Ondersteunt uitvoer met --json en eigen paden zoals mo analyze /Volumes voor externe schijven.

mo status

Live systeemoverzicht: CPU, GPU, geheugen, schijf-I/O, netwerk, batterij, temperaturen, uptime, gezondheidsscore en de drukste processen met sparklines van 60 seconden. Ondersteunt --json om door te geven aan andere tools.

Alleen-CLI-commando's

mo purge

Vindt oude buildartefacten in projectmappen: node_modules, target, .build, build, dist, venv. Scant instelbare paden (standaard: ~/Projects, ~/GitHub, ~/dev). Projecten jonger dan 7 dagen worden gemarkeerd als "Recent" en zijn standaard niet geselecteerd. Ondersteunt --dry-run en --paths om de scanmappen in te stellen.

mo installer

Vindt installatiebestanden .dmg, .pkg en .zip in Downloads, Bureaublad, de Homebrew-cache, iCloud en Mail-bijlagen. Labelt elk bestand naar de bronlocatie. Ondersteunt --dry-run.

mo touchid

Zet Touch ID aan voor sudo-commando's. Voer mo touchid enable uit om in te stellen, mo touchid disable om terug te draaien. Ondersteunt --dry-run.

Hulpcommando's

mo completion

Stelt tabaanvulling van de shell in voor Bash en Zsh. Herkent je shell automatisch en werkt het bijpassende configuratiebestand bij.

mo update

Werkt zichzelf bij naar de nieuwste stabiele versie. Gebruik --nightly voor de nieuwste nog niet uitgebrachte build van main (alleen bij installatie via het script). Gebruik --force om de huidige versie opnieuw te installeren.

mo remove

Verwijdert Mole CLI van je systeem, inclusief configuratiebestanden en shellintegratie. Ondersteunt --dry-run.

Veiligheid

De CLI en de Mac-app delen dezelfde veiligheidsprincipes:

Padbescherming. Een ingebouwde weigerlijst dekt mappen die cruciaal zijn voor het systeem, de essentiële structuur van je thuismap, en alles buiten bekende cachelocaties. Symlinks worden opgelost en gecontroleerd vóór elke bewerking.

Procesbewustzijn. Caches van draaiende apps worden tijdens het opschonen overgeslagen. Browsercaches worden niet aangeraakt zolang de browser open is.

Gratis proberen en activeren. In de Mac-app werkt elke betaalde tool (Opschonen, Apps, Optimaliseren, en onderdelen naar de prullenmand verplaatsen in Analyse) twee keer gratis. Daarna is een actieve licentie nodig. Scannen is altijd gratis.

Whitelist. Zowel de CLI (~/.config/mole/whitelist) als de Mac-app laat je specifieke caches of optimalisatietaken beschermen tegen latere rondes.

Bewerkingslog. Elke verwijdering wordt vastgelegd in ~/Library/Logs/mole/operations.log. Het Diagnosepaneel van de Mac-app controleert de gezondheid van dit log en toont recente mislukkingen.

Eerst bekijken. De CLI ondersteunt --dry-run bij elk commando dat iets verwijdert. In de Mac-app tonen Opschonen en Verwijderen de volledige bestandslijst en het aantal bytes voordat er iets weggaat, en Analyse verplaatst losse onderdelen naar de prullenmand, waar je ze kunt terugzetten.

Problemen oplossen

De Mac-app bevat een ingebouwde Diagnose die veelvoorkomende problemen herkent. Open die door linksboven in het venster op het Mole-logo te klikken en Voer diagnose uit te kiezen. Voor specifieke situaties, zie de helppagina.

Voeg voor de CLI --debug toe aan elk commando voor uitgebreide logs. Bekijk het bewerkingslog op ~/Library/Logs/mole/operations.log voor recente activiteit. Als een commando stil mislukt, controleer dan of Volledige schijftoegang is gegeven in Systeeminstellingen.

Om problemen te melden, zie het onderdeel Een probleem melden op de helppagina.