Documentazione

Panoramica

L’app Mac e la CLI di Mole coprono categorie di pulizia simili e condividono le stesse regole di sicurezza prudenti e liste di protezione, ma non hanno esattamente le stesse funzioni. La CLI è gratuita, open source e con licenza GPL-3.0. L’app Mac è un’app nativa scritta in SwiftUI con licenza una tantum da $19, aggiornamenti gratuiti e nessun abbonamento. Offre un’interfaccia grafica per la pulizia e la manutenzione del Mac; la CLI aggiunge alcuni comandi esclusivi per il terminale.

App Mac

Installazione

Scarica il DMG dalla home page, oppure installa tramite Homebrew: brew install --cask mole-app.

Pulizia (Terra)

Scansiona dieci categorie: cache delle app, cache di sistema e log, strumenti di sviluppo (Xcode, npm, pip, Gradle), strumenti AI (ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), browser (Chrome, Edge, Arc, Safari, Firefox), client di cloud storage, strumenti di design (Adobe, Figma, Sketch), app di comunicazione (Slack, Discord, WeChat, Zoom) e file temporanei vari. Il Cestino è elencato separatamente in fondo.

L’elenco di revisione è ordinato per impatto della cancellazione: le cache rigenerabili compaiono per prime, lo stato visibile all’utente per ultimo, il Cestino sempre in fondo. Il calcolo delle dimensioni tiene conto degli hardlink, quindi i file condivisi tra strumenti (uv, pnpm) non vengono conteggiati due volte. Le cache vengono eliminate definitivamente per impostazione predefinita. Puoi scegliere il Cestino nelle Impostazioni. Le dimensioni rilevate durante la scansione possono differire dallo spazio effettivamente liberato.

Da verificare per impostazione predefinita: cache di pacchetti con un costo reale di ricostruzione (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) e output di progetto rigenerabili senza scaricare dipendenze (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). L’app Mac non propone cartelle di dipendenze scaricate come node_modules, Pods e venv: ricrearle richiede la rete e potrebbe non riprodurre lo stato del lockfile. Queste voci restano deselezionate finché non confermi; nelle Impostazioni puoi inviare la pulizia al Cestino.

App (Marte)

La scheda App unisce aggiornamenti, gestione dell’avvio e pulizia della disinstallazione. La vista Update controlla app Sparkle, Homebrew Cask / Formula e Mac App Store, poi installa gli aggiornamenti supportati sul posto o apre l’App Store quando macOS richiede quel passaggio.

La vista Avvio elenca Login Items, Launch Agents, Launch Daemons ed elementi in background. Puoi disattivare le voci supportate, rivelare i file o aprire Impostazioni di Sistema per gli elementi gestiti da Apple.

Per disinstallare, scegli le app da rimuovere. Mole trova residui in oltre quindici sottodirectory Library, incluse Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State e Input Methods. Le voci Dock vengono pulite automaticamente e i residui ambigui o debolmente associati restano visibili ma non selezionati per la revisione.

Gli aggiornamenti avvengono in-app dove possibile: Sparkle e Homebrew Cask si installano dentro Mole; Mac App Store passa da CommerceKit e ripiega sull’app dell’App Store in caso di problemi di auth o timeout; le altre app si aprono per lasciare il controllo al loro updater. Cmd-clic aggiunge righe a un batch di disinstallazione multipla e ogni fallimento per app resta in lista per riprovare.

I bundle /Applications/*.app di proprietà root richiedono una conferma amministratore alla prima rimozione di una sessione; le rimozioni successive riutilizzano la stessa autorizzazione fino alla chiusura di Mole. La vista Avvio permette a Mole di commutare direttamente Login Items e LaunchAgents / LaunchDaemons verificati quando li può associare a un servizio launchd stabile; le voci gestite dal background task management di macOS senza un riferimento chiaro vengono instradate al pannello Impostazioni di Sistema corrispondente.

Ottimizza (Mercurio)

Le operazioni di manutenzione predefinite vengono eseguite con un clic. Le operazioni senza privilegi admin sono silenziose; quelle admin vengono raggruppate dietro una sola autorizzazione quando serve.

Ottimizza parte con un tentativo di riparazione per il cambio del metodo di input, Spotlight, Centro Notifiche e Appunti universali. Le operazioni più profonde includono Quick Look, vacuum SQLite, stati salvati, eventi di quarantena, cronologia notifiche, preferenze danneggiate, Launch Agents, shared file lists, regole Spotlight orfane, audit degli elementi di login e periodic maintenance.

I controlli di sicurezza saltano le operazioni quando le condizioni non sono sicure e ogni operazione viene eseguita solo se serve davvero. Reset DNS o dello stack di rete non fanno parte della manutenzione predefinita.

Ottimizza salta un’operazione quando il suo controllo dice che non serve, come la pulizia della memoria se la pressione è già normale o la compattazione dei database di Mail e Messaggi mentre quelle app sono in esecuzione; le operazioni saltate mostrano un motivo nel pannello dei risultati così puoi vedere cosa è stato eseguito.

Analizza (Giove)

Una visualizzazione a mappa ad albero dell’intero disco. Esplora qualsiasi directory per vedere le dimensioni a ogni livello. Gli elementi densi o di dimensione simile vengono raccolti in blocchi di riepilogo per mantenere leggibile la mappa.

Le voci le cui dimensioni non possono essere determinate (cartelle con restrizioni di permessi, container protetti dal TCC) vengono mostrate con la possibilità di riprovare invece di essere scartate in silenzio. Le radici di navigazione protette (/, /Users, /Applications) non possono essere cestinate. I risultati della scansione del disco vengono memorizzati nella cache per 24 ore, così la riapertura è immediata.

Un singolo clic su una directory nella treemap entra al suo interno; la riga di breadcrumb sopra la mappa torna a qualsiasi antenato. La lista a sinistra e i blocchi reali della treemap mantengono le azioni: apri o mostra nel Finder, e clic destro per Sposta nel Cestino con conferma. I blocchi di riepilogo sono solo panoramici. L’area di ogni blocco nella treemap è proporzionale ai byte, quindi gli elementi più grandi disegnano sempre i blocchi più grandi.

Stato (Sole)

Il pannello di stato mostra punteggio salute, CPU, memoria, GPU, I/O disco, rete, batteria o temperatura, più una scheda ventole o temperatura in base all’hardware. I grafici mostrano l’andamento recente e i Mac supportati mostrano i modi ventola Auto, Fresco e Max.

L’elenco processi sotto la griglia si aggiorna ogni secondo. Tutte e cinque le colonne (Nome, PID, CPU, Power, Memoria) si ordinano al clic; clicca di nuovo per invertire la direzione. Clicca una riga per aprire la sua scheda di spiegazione. Clic destro su una riga per fissare o sganciare (i processi fissati restano al loro posto tra un aggiornamento e l’altro e dopo il riavvio dell’app), Termina (prima normalmente, poi in modo forzato se il processo non risponde) e copiare il percorso eseguibile. La riga del processo che consuma di più nel riquadro Batteria rimanda direttamente a quel processo nella scheda di spiegazione.

Pannello della barra dei menu

Un monitor facoltativo, sempre attivo nella barra dei menu di macOS. Scegli metriche live, icona compatta o una piccola animazione runner che segue il carico del sistema. Il popover mostra schede hardware, controllo ventole dove supportato, processi principali e la cronologia pulizia.

Gli strumenti rapidi vivono in fondo al popover: indicatori camera o microfono, Schermo sempre acceso (Keep Screen On) con durata, Pulisci schermo (Clean Screen) per mettere lo schermo in tinta unita e pulire display e tastiera, con un blocco input opzionale che usa il permesso «Accessibilità» di macOS, e un pulsante Espelli quando un disco esterno o un’immagine può essere smontato. Una scorciatoia globale apre Mole da ovunque; con Solo barra dei menu, Mole resta nella barra dei menu mentre gira in background. Configurazione in Impostazioni › Barra menu.

Avvisi privacy per app. Quando una notifica indica il nome di un’app, passaci sopra e scegli Non avvisare più per questa app. Puoi riattivarla in seguito da Impostazioni › Barra menu › Notifiche › App senza avvisi privacy. Gli avvisi della sola fotocamera restano generici perché macOS non rivela quale app la usa; Mole quindi non mostra un’azione per app in quegli avvisi.

La Modalità di visualizzazione passa tra l’animazione del runner e una vista Metrics di due righe configurabili. Ogni riga prende CPU, Memoria, Pressione, Swap, GPU, Disco, Temperatura, Batteria, Potenza, Ventola o Dispositivi, e le due non possono portare la stessa metrica. La velocità di rete è un interruttore a sé e aggiunge una colonna propria accanto a quelle due righe. Il personaggio runner è puramente visivo e non cambia le metriche campionate.

Doctor

Nell’app, clicca il logo Mole in alto a sinistra nella finestra e scegli Esegui Doctor. Mole raccoglie un breve rapporto diagnostico in sola lettura su modello del Mac, versione di macOS, permessi, operazioni recenti, display, volumi esterni, rete, stato di sicurezza e ambiente di sistema. Clicca Copia rapporto e incollalo nel messaggio per il supporto.

Doctor rileva cinque condizioni: Accesso completo al disco mancante, pressione della memoria elevata, utilizzo disco superiore al 90%, registro operazioni non scrivibile e operazioni recenti fallite. Ogni condizione rimanda a un articolo di aiuto con i passaggi per la risoluzione. Consulta la pagina di aiuto per i dettagli su ciascuna.

Impostazioni

Impostazioni ha tre schede. Generali: lingua interfaccia, Avvia all’accesso, Solo barra dei menu, attivazione licenza e gestione dispositivi, scorciatoia per accesso completo al disco. Strumenti: Rimozione cache e Elementi protetti. Battery Care mantiene la batteria interna tra il 75% e l’80% mentre Mole è in esecuzione per rallentare l’usura, sui Mac supportati con un’autorizzazione amministratore. Barra menu: icona barra dei menu, cambio tra runner e metriche, metriche visibili, comportamento ventole dove supportato e scorciatoie Apri Mole / Schermo sempre acceso / Pulisci schermo. L’attivazione licenza è sempre disponibile con Cmd + Shift + L.

CLI

Installazione

Installa Mole con Homebrew: brew install mole. Esegui mo per il menu interattivo, oppure usa direttamente un sottocomando.

Comandi condivisi (presenti anche nell’app Mac)

mo clean

Pulizia approfondita delle stesse dieci categorie dell’app Mac. Supporta --dry-run per l’anteprima senza cancellazione, --debug per log dettagliati e --whitelist per gestire le cache protette. Salta automaticamente le cache delle app in esecuzione.

mo uninstall

Selezione interattiva delle app con rilevamento dei residui. Mostra dimensione dell’app, bundle ID e data di ultimo utilizzo. Trova le stesse quindici e più categorie di residui dell’app Mac. Supporta --dry-run.

mo optimize

Esegue le operazioni di manutenzione della CLI. Le operazioni admin richiedono la password. L’elenco esatto può differire dalla lista Ottimizza predefinita dell’app Mac. --whitelist permette di escludere operazioni specifiche dalle esecuzioni future.

mo analyze

Mappa ad albero interattiva nel terminale. Naviga con i tasti freccia o le associazioni Vim (h/j/k/l). Cestina i file direttamente dalla mappa. Supporta l’output --json e percorsi personalizzati come mo analyze /Volumes per i dischi esterni.

mo status

Dashboard di sistema in tempo reale: CPU, GPU, memoria, I/O disco, rete, batteria, temperatura, uptime, punteggio di salute e processi principali con sparkline di sessanta secondi. Supporta --json per il piping ad altri strumenti.

Comandi esclusivi della CLI

mo purge

Trova vecchi artefatti di build nelle directory dei progetti: node_modules, target, .build, build, dist, venv. Scansiona percorsi configurabili (predefiniti: ~/Projects, ~/GitHub, ~/dev). I progetti più recenti di 7 giorni sono contrassegnati come "Recent" e deselezionati per impostazione predefinita. Supporta --dry-run e --paths per configurare le directory di scansione.

mo installer

Scopre i file di installazione .dmg, .pkg e .zip in Download, Scrivania, cache di Homebrew, iCloud e allegati di Mail. Etichetta ogni file per posizione di origine. Supporta --dry-run.

mo touchid

Abilita Touch ID per i comandi sudo. Esegui mo touchid enable per configurare, mo touchid disable per ripristinare. Supporta --dry-run.

Comandi di utilità

mo completion

Configura il completamento automatico tramite Tab per Bash e Zsh. Rileva automaticamente la tua shell e aggiorna il file di configurazione appropriato.

mo update

Aggiornamento automatico all’ultima versione stabile. Usa --nightly per l’ultima build non rilasciata dal ramo main (solo installazione tramite script). Usa --force per reinstallare la versione corrente.

mo remove

Disinstalla la CLI di Mole dal tuo sistema, inclusi i file di configurazione e l’integrazione con la shell. Supporta --dry-run.

Sicurezza

Sia la CLI che l’app Mac condividono gli stessi principi di sicurezza:

Protezione dei percorsi. Una lista di blocco integrata copre le directory critiche di sistema, la struttura essenziale della cartella home e tutto ciò che si trova fuori dalle posizioni di cache note. I link simbolici vengono risolti e validati prima di qualsiasi operazione.

Consapevolezza dei processi. Le cache delle app in esecuzione vengono saltate durante la pulizia. Le cache del browser non vengono toccate mentre il browser è aperto.

Prova gratuita e attivazione. Nell’app Mac, ogni strumento a pagamento (Pulizia, App, Ottimizza e lo spostamento nel Cestino da Analizza) funziona due volte gratis. Dopo serve una licenza attiva. La scansione è sempre gratuita.

Lista consentiti. Sia la CLI (~/.config/mole/whitelist) che l’app Mac permettono di proteggere cache o operazioni di ottimizzazione specifiche dalle esecuzioni future.

Registro operazioni. Ogni cancellazione viene registrata in ~/Library/Logs/mole/operations.log. Il pannello Doctor dell’app Mac verifica la salute di questo registro e segnala eventuali errori recenti.

Anteprima prima di agire. La CLI supporta --dry-run su ogni comando distruttivo. L’app Mac mostra l’elenco completo dei file e la dimensione in byte prima di qualsiasi azione.

Risoluzione dei problemi

L’app Mac include un Doctor integrato che rileva i problemi comuni. Aprilo cliccando il logo Mole in alto a sinistra nella finestra e scegliendo Esegui Doctor. Per le condizioni specifiche, consulta la pagina di aiuto.

Per la CLI, aggiungi --debug a qualsiasi comando per log dettagliati. Consulta il registro operazioni in ~/Library/Logs/mole/operations.log per l’attività recente. Se un comando fallisce silenziosamente, verifica che l’Accesso completo al disco sia concesso nelle Impostazioni di Sistema.

Per segnalare problemi, consulta la sezione Segnalare un problema nella pagina di aiuto.