Documentation

Vue d’ensemble

L’app Mac et le CLI de Mole couvrent des catégories de nettoyage proches et partagent les mêmes règles de sécurité prudentes et listes de protection, sans avoir exactement les mêmes capacités. Le CLI est gratuit, open source et sous licence GPL-3.0. L’app Mac est une application native écrite en SwiftUI à 19 $ en achat unique, avec mises à jour à vie et sans abonnement. Elle exécute nativement les opérations Mac ; le CLI ajoute quelques commandes propres au terminal.

App Mac

Installation

Téléchargez le DMG depuis la page d’accueil, ou installez via Homebrew : brew install --cask mole-app.

Nettoyer (Terre)

Scanne dix catégories : caches d’apps, caches système et journaux, outils de développement (Xcode, npm, pip, Gradle), outils IA (ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), navigateurs (Chrome, Edge, Arc, Safari, Firefox), clients de stockage cloud, outils de design (Adobe, Figma, Sketch), apps de communication (Slack, Discord, WeChat, Zoom) et fichiers temporaires divers. La Corbeille est listée séparément à la fin.

La liste de revue est triée par impact de suppression : les caches régénérables apparaissent en premier, les données visibles par l’utilisateur en dernier, la Corbeille toujours en fin de liste. Le dimensionnement tenant compte des liens physiques évite de compter deux fois les fichiers partagés entre outils (uv, pnpm). Les caches sont supprimés définitivement par défaut. Vous pouvez choisir la Corbeille dans les Réglages. La taille des fichiers analysés peut différer de l’espace réellement libéré.

À vérifier par défaut : les caches de paquets dont la reconstruction a un coût réel (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) et les sorties de projet régénérables sans télécharger de dépendances (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). L’app Mac ne propose pas les dossiers de dépendances téléchargées comme node_modules, Pods et venv : leur reconstruction exige le réseau et peut ne pas reproduire l’état du fichier de verrouillage. Ces éléments restent décochés jusqu’à confirmation ; les Réglages peuvent envoyer le nettoyage vers la Corbeille.

Apps (Mars)

L’onglet Apps regroupe les mises à jour d’apps, la gestion du démarrage et le nettoyage de désinstallation. La section Mises à jour vérifie les apps Sparkle, Homebrew Cask / Formula et Mac App Store, puis installe les mises à jour prises en charge sur place ou ouvre l’App Store lorsque macOS l’impose.

La section Démarrage liste les éléments de connexion, Launch Agents, Launch Daemons et éléments d’arrière-plan. Vous pouvez désactiver les entrées prises en charge, révéler leurs fichiers ou ouvrir les Réglages Système pour les éléments gérés par Apple.

Pour désinstaller, choisissez les apps à supprimer. Mole trouve les restes dans plus de quinze sous-répertoires Library, dont Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State et Input Methods. Les entrées Dock sont nettoyées automatiquement, et les restes ambigus ou faiblement associés restent visibles mais décochés pour revue.

Les mises à jour s’installent dans l’app quand c’est possible : Sparkle et Homebrew Cask sont gérées dans Mole ; le Mac App Store passe par CommerceKit et bascule vers l’app App Store en cas d’auth ou de timeout ; les autres apps s’ouvrent pour laisser leur propre updater prendre le relais. Cmd-clic ajoute des lignes à un lot de désinstallation multiple, et chaque échec par app reste dans la liste pour réessai.

Les bundles /Applications/*.app appartenant à root demandent une confirmation administrateur à la première suppression d’une session ; les suppressions suivantes réutilisent la même autorisation jusqu’à la sortie de Mole. La section Démarrage permet à Mole d’activer ou de désactiver directement les éléments de connexion et les LaunchAgents / LaunchDaemons vérifiés lorsqu’il peut les associer à un service launchd stable ; les entrées gérées par macOS auxquelles aucun service identifiable ne correspond sont dirigées vers le panneau Réglages Système concerné.

Optimiser (Mercure)

Les tâches de maintenance par défaut s’exécutent en un clic. Les tâches sans droits admin s’exécutent silencieusement ; les tâches admin sont regroupées derrière une seule autorisation si nécessaire.

Optimiser commence par une tentative de réparation pour le changement de méthode de saisie, Spotlight et le Centre de notifications. Les tâches plus profondes couvrent Quick Look, le vacuum SQLite, les états enregistrés, les événements de quarantaine, l’historique de notifications, les préférences cassées, les Launch Agents, les listes de fichiers partagés, les règles Spotlight orphelines, l’audit des éléments d’ouverture et la maintenance périodique.

Des garde-fous écartent les tâches lorsque les conditions ne s’y prêtent pas, et chacune ne s’exécute que si elle est réellement nécessaire. La réinitialisation du DNS ou de la pile réseau ne fait pas partie de la maintenance par défaut.

Optimiser ignore une tâche quand sa propre vérification la juge inutile, par exemple la purge mémoire lorsque la pression mémoire est saine ou le compactage des bases de Mail et Messages tant que ces apps sont ouvertes ; les tâches ignorées affichent une raison dans le panneau de résultats.

Analyser (Jupiter)

Un treemap de l’ensemble de votre disque. Explorez n’importe quel répertoire pour voir la taille à chaque niveau. Les zones denses ou de taille proche sont regroupées en blocs de résumé pour garder la carte lisible.

Les entrées dont la taille n’a pas pu être déterminée (dossiers à accès restreint, conteneurs protégés par TCC) sont signalées avec une option de nouvel essai au lieu d’être ignorées silencieusement. Les racines de navigation protégées (/, /Users, /Applications) ne peuvent pas être supprimées. Les résultats de scan sont mis en cache pendant 24 heures pour un accès rapide.

Cliquez une fois sur un répertoire dans le treemap pour y entrer ; la barre de fil d’Ariane au-dessus de la carte permet de remonter à n’importe quel ancêtre. La liste de gauche et les vrais blocs du treemap gardent les actions : ouvrir ou afficher dans le Finder, et clic droit pour Placer dans la corbeille avec confirmation. Les blocs de résumé servent uniquement à l’aperçu. La surface de chaque bloc dans le treemap est proportionnelle à la taille en octets, donc les éléments les plus volumineux occupent les plus grands blocs.

État (Soleil)

Le tableau de bord affiche le score de santé, CPU, mémoire, GPU, E/S disque, réseau, batterie ou température, avec une tuile ventilateurs ou température selon le matériel. Des graphiques montrent l’évolution récente des mesures, et les Mac compatibles affichent les modes ventilateur Auto, Frais et Max.

La liste de processus se met à jour chaque seconde. Les cinq colonnes (Nom, PID, CPU, Puissance, Mémoire) se trient au clic ; cliquez de nouveau pour inverser le sens. Un clic sur une ligne ouvre sa fiche d’explication. Un clic droit propose Épingler ou Détacher (les processus épinglés restent en haut de la liste après les rafraîchissements et les redémarrages de l’app, pour suivre une app sans la perdre dans le défilement), Terminer (une fermeture normale, puis forcée si le processus ne répond pas) et copier le chemin de l’exécutable. La ligne Plus gros consommateur de la tuile Batterie renvoie directement au processus correspondant dans la fiche d’explication.

Panneau de la barre des menus

Un moniteur optionnel toujours visible dans la barre des menus macOS. Choisissez des mesures en direct, une icône compacte ou un petit coureur animé par la charge système. Le popover affiche les cartes matériel, le contrôle des ventilateurs si disponible, les processus les plus actifs et un historique de nettoyage.

Les outils rapides sont regroupés en bas du popover : indicateurs caméra ou micro, Garder l’écran allumé (Keep Screen On) avec choix de durée, Nettoyer l’écran (Clean Screen) pour passer l’écran en couleur unie afin d’essuyer écran et clavier, avec un verrou de saisie optionnel qui passe par l’autorisation macOS « Accessibilité », et un bouton Éjecter quand un disque externe ou une image disque peut être démonté. Le raccourci global ouvre Mole de partout ; avec Barre des menus uniquement, Mole reste dans la barre des menus en arrière-plan. Configuration dans Réglages › Barre des menus.

Alertes de confidentialité par app. Lorsqu’une notification nomme une app, survolez-la et choisissez Ne plus avertir pour cette app. Vous pourrez la réactiver dans Réglages › Barre des menus › Notifications › Apps sans alertes de confidentialité. Une alerte concernant uniquement la caméra reste générique, car macOS ne révèle pas l’app qui l’utilise ; Mole n’y propose donc pas d’action par app.

Le mode d’affichage bascule entre l’animation du coureur et une vue Metrics de deux lignes configurables. Chaque ligne prend CPU, Mémoire, Pression, Swap, GPU, Disque, Température, Batterie, Puissance, Ventilateur ou Appareils, et les deux ne peuvent pas porter la même mesure. Le débit réseau est un réglage distinct qui ajoute sa propre colonne à côté de ces deux lignes. Le personnage du coureur est purement visuel et ne change pas les métriques échantillonnées.

Diagnostic

Dans l’app, cliquez sur le logo Mole en haut à gauche de la fenêtre et choisissez Lancer le diagnostic. Mole génère un court rapport de diagnostic en lecture seule couvrant votre modèle de Mac, la version macOS, les permissions, les opérations récentes, les écrans, les volumes externes, le réseau, l’état de sécurité et l’environnement. Cliquez sur Copier le rapport, puis collez-le dans votre message au support.

Le Diagnostic détecte cinq conditions : accès complet au disque manquant, pression mémoire élevée, utilisation du disque supérieure à 90 %, journal d’opérations inaccessible en écriture et échecs d’opérations récentes. Chaque condition renvoie à un article d’aide avec les étapes de résolution. Consultez la page d’aide pour les détails de chaque condition.

Réglages

Réglages comporte trois onglets. Général : langue de l’interface, Lancer à l’ouverture de session, Barre des menus uniquement, activation de licence et gestion des appareils, raccourci vers l’accès complet au disque. Outils : Suppression du cache et Éléments protégés. Battery Care maintient la batterie interne entre 75 % et 80 % pendant que Mole tourne pour ralentir l’usure, sur les Mac compatibles avec une autorisation administrateur. Barre des menus : icône de barre des menus, choix entre coureur et mesures, mesures visibles, comportement des ventilateurs si pris en charge et raccourcis Ouvrir Mole / Garder l’écran allumé / Nettoyer l’écran. L’activation de licence est aussi disponible avec Cmd + Shift + L.

CLI

Installation

Installez Mole avec Homebrew : brew install mole. Lancez mo pour le menu interactif, ou n’importe quelle sous-commande directement.

Commandes partagées (aussi dans l’app Mac)

mo clean

Nettoyage en profondeur des mêmes dix catégories que l’app Mac. Prend en charge --dry-run pour un aperçu sans suppression, --debug pour des journaux détaillés et --whitelist pour gérer les caches protégés. Ignore automatiquement les caches des apps en cours d’exécution.

mo uninstall

Sélection interactive d’apps avec détection des résidus. Affiche la taille de l’app, le bundle ID et la date de dernière utilisation. Recherche les mêmes quinze catégories de résidus (et plus) que l’app Mac. Prend en charge --dry-run.

mo optimize

Exécute les tâches de maintenance du CLI. Les tâches admin demandent votre mot de passe. L’ensemble exact peut différer de la liste Optimiser par défaut de l’app Mac. --whitelist permet d’exclure certaines tâches des prochains passages.

mo analyze

Treemap interactif dans le terminal. Naviguez avec les flèches ou les raccourcis Vim (h/j/k/l). Supprimez des fichiers directement depuis la carte. Prend en charge --json et les chemins personnalisés comme mo analyze /Volumes pour les disques externes.

mo status

Tableau de bord système en direct : CPU, GPU, mémoire, E/S disque, réseau, batterie, température, durée de fonctionnement, score de santé et processus principaux avec sparklines de soixante secondes. Prend en charge --json pour le piping vers d’autres outils.

Commandes exclusives au CLI

mo purge

Recherche les anciens artefacts de build dans les répertoires de projets : node_modules, target, .build, build, dist, venv. Scanne des chemins configurables (par défaut : ~/Projects, ~/GitHub, ~/dev). Les projets de moins de 7 jours sont marqués "Recent" et décochés par défaut. Prend en charge --dry-run et --paths pour configurer les répertoires de scan.

mo installer

Découvre les fichiers d’installation .dmg, .pkg et .zip dans Téléchargements, Bureau, cache Homebrew, iCloud et les pièces jointes Mail. Identifie chaque fichier par son emplacement source. Prend en charge --dry-run.

mo touchid

Active Touch ID pour les commandes sudo. Lancez mo touchid enable pour configurer, mo touchid disable pour revenir en arrière. Prend en charge --dry-run.

Commandes utilitaires

mo completion

Configure l’autocomplétion par tabulation pour Bash et Zsh. Détecte automatiquement votre shell et met à jour le fichier de configuration correspondant.

mo update

Mise à jour automatique vers la dernière version stable. Utilisez --nightly pour la dernière build non publiée de main (installations par script uniquement). Utilisez --force pour réinstaller la version actuelle.

mo remove

Désinstalle Mole CLI de votre système, y compris les fichiers de configuration et l’intégration shell. Prend en charge --dry-run.

Sécurité

Le CLI et l’app Mac partagent les mêmes principes de sécurité :

Protection des chemins. Une liste de refus intégrée couvre les répertoires critiques du système, la structure essentielle de votre dossier personnel et tout ce qui se trouve hors des emplacements de cache connus. Les liens symboliques sont résolus et validés avant toute opération.

Détection des processus. Les caches des apps en cours d’exécution sont ignorés pendant le nettoyage. Les caches de navigateurs ne sont pas touchés quand le navigateur est ouvert.

Essai gratuit et activation. Dans l’app Mac, chaque outil payant (Nettoyer, Apps, Optimiser, et la mise à la corbeille depuis Analyser) fonctionne deux fois gratuitement. Ensuite, une licence active est requise. Le scan est toujours gratuit.

Liste blanche. Le CLI (~/.config/mole/whitelist) et l’app Mac permettent de protéger des caches ou des tâches d’optimisation spécifiques pour les futures exécutions.

Journal d’opérations. Chaque suppression est enregistrée dans ~/Library/Logs/mole/operations.log. Le panneau de Diagnostic de l’app Mac vérifie la santé de ce journal et signale les échecs récents.

Aperçu d’abord. Le CLI prend en charge --dry-run pour chaque commande destructrice. L’app Mac affiche la liste complète des fichiers et le nombre d’octets avant toute action.

Dépannage

L’app Mac inclut un diagnostic intégré qui détecte les problèmes courants. Ouvrez-le en cliquant sur le logo Mole en haut à gauche de la fenêtre, puis choisissez Lancer le diagnostic. Pour les conditions spécifiques, consultez la page d’aide.

Pour le CLI, ajoutez --debug à n’importe quelle commande pour des journaux détaillés. Consultez le journal d’opérations dans ~/Library/Logs/mole/operations.log pour l’activité récente. Si une commande échoue silencieusement, vérifiez que l’accès complet au disque est accordé dans les Réglages Système.

Pour signaler des problèmes, consultez la section Signaler un problème de la page d’aide.