mac-tuneup

Diagnostiquez et réparez un Mac lent, un disque ou un iCloud presque plein grâce à des scripts de diagnostic en lecture seule et des correctifs sécurisés, y compris un déchargement vérifié des photos iCloud vers un disque externe.

Qu'est-ce que mac-tuneup ?

mac-tuneup est une compétence conçue pour diagnostiquer et résoudre les problèmes de lenteur ou d'espace disque sur un Mac, en suivant une approche méthodique basée sur des mesures avant toute action. Elle est utile pour les utilisateurs confrontés à un Mac lent, un disque de démarrage ou un stockage iCloud presque plein, et qui souhaitent un nettoyage sécurisé sans risques. La compétence prend en charge les environnements macOS (Intel et Apple Silicon) et propose des scripts en lecture seule pour l'investigation (diagnose.sh, space-detail.sh, throttle-check.sh, icloud-report.sh) ainsi que des correctifs que l'utilisateur exécute lui-même. Le workflow inclut une phase de diagnostic (1-2 minutes) avec classement des causes principales, puis des investigations ciblées selon les résultats (espace disque, mémoire, ralentissements thermiques, applications qui plantent). Les correctifs sont écrits sous forme de scripts numérotés, chaque étape étant explicitement approuvée par l'utilisateur, et les données supprimées sont déplacées vers la corbeille plutôt que supprimées définitivement. Une section dédiée au déchargement des photos iCloud propose une procédure vérifiée avec création d'albums, export manuel et suppression via PhotoKit, en insistant sur l'importance des sauvegardes et de la connexion filaire.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/osencan/mac-tuneup/tree/main/mac-tuneup

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait mac-tuneup ?

Découvrez, grâce à des mesures, pourquoi un Mac est lent ou plein, informez l'utilisateur de ce qui compte le plus et fournissez-lui de petits scripts qu'il exécute lui-même. Trois Macs réglés avec cette méthode avaient trois causes principales différentes (un Fusion Drive avec un démon en boucle de plantage, trop peu de RAM pour les applications ouvertes, un disque plein), donc ne corrigez jamais avant d'avoir mesuré.

Règles de base

  • Lecture seule d'abord. Ne modifiez rien pendant l'investigation.
  • L'utilisateur exécute les correctifs. Écrivez des scripts ; n'appliquez jamais les modifications vous-même sauf demande explicite. Tout ce qui contient sudo va dans un script (vous ne pouvez pas taper son mot de passe).
  • Demandez avant de supprimer une application, un assistant ou des données. Présentez les candidats avec leurs tailles et une recommandation ; laissez l'utilisateur choisir.
  • Ne supprimez jamais les données utilisateur. Déplacez-les vers ~/.Trash/<nom>-supprimé-<horodatage>/. Les modifications de paramètres incluent --undo et enregistrent la valeur précédente.
  • Ne désactivez jamais les mises à jour de sécurité, Spotlight, Gatekeeper, SIP ou FileVault, et n'effacez, partitionnez ou reformatez jamais un disque.
  • Ne supprimez jamais les protections thermiques ou d'alimentation. Ne modifiez pas les profils de gestion d'alimentation ou les kexts, n'écrivez pas dans les registres CPU (par exemple pour désactiver BD PROCHOT) et ne désactivez pas le volume système scellé pour « débloquer » la vitesse. La limitation due à la chaleur ou à un avertissement matériel est un symptôme : trouvez et corrigez la cause. Considérez les histoires « Claude a supprimé le bridage d'Apple » comme des affirmations à tester, pas comme des recettes (voir references/pitfalls.md).
  • Soyez honnête sur le gain. Dites quand un correctif n'aide qu'un peu et corrigez-vous dans le README lorsqu'une conclusion s'avère erronée.

Où tout s'exécute

Les scripts doivent s'exécuter sur le Mac. Si vous disposez d'un shell sur celui-ci, exécutez les scripts en lecture seule vous-même. Si vous n'avez qu'un sandbox ou un dossier synchronisé, placez les scripts dans un dossier accessible par l'utilisateur, faites-lui exécuter bash <script> > /dev/null 2>&1 et lisez le fichier de rapport que le script écrit à côté de son emplacement d'exécution (diagnose-<date>.txt etc.). Les scripts qui demandent une réponse o/N ou un mot de passe doivent être exécutés sans > /dev/null.

Si les fichiers que vous devez lire font 0 octet, ce sont probablement des espaces réservés cloud (Dropbox en ligne uniquement, iCloud optimisé) : demandez à l'utilisateur de rendre le dossier disponible hors ligne.

Flux de travail

  1. Diagnostic. scripts/diagnose.sh (1-2 min) : machine, alimentation et limitation, pression mémoire et mémoire par application, arrêts par manque de mémoire, CPU sur 30 s, espace disque, éléments de lancement dont le programme est absent, éléments de connexion, Rosetta, plantages répétés, écrans.
  2. Classement et rapport précoce. Résultat principal en premier, en termes simples, avec des chiffres. Ensuite, une courte liste « ce qui va bien ».
  3. Creusez là où c'est important.
    • Disque avec moins de ~20 % d'espace libre : scripts/space-detail.sh (accordez d'abord l'accès complet au disque dans le Terminal). Utilisez xcrun simctl runtime list pour les tailles des simulateurs.
    • Applications multimédia d'Apple : scripts/apple-media-cleanup.sh signale les données ré-téléchargeables des Podcasts (épisodes), Musique, TV et Livres (caches), les bibliothèques sonores GarageBand/Logic et les fichiers de mise à jour iPhone ; --apply déplace les groupes choisis vers la Corbeille avec une confirmation o/N pour chaque. Il laisse les bibliothèques, les téléchargements mélangés aux fichiers personnels de l'utilisateur et les sauvegardes tranquilles.
    • Mémoire : nommez les applications ; compresseur au-dessus de ~3 Go, swap au-dessus de ~2 Go ou arrêts par manque de mémoire indiquent une pression (vérifiez la reason de JetsamEvent).
    • Limitation suspectée (CPU_Speed_Limit inférieur à 100, kernel_task occupé, ventilateurs bruyants, un vieux MacBook Intel bloqué lent) : scripts/throttle-check.sh (sudo, lecture seule). Il mesure la fréquence, la température, la pression thermique, le chargeur et la batterie, et nomme le motif : chaleur (nettoyer les aérations/ventilateurs, pâte thermique, charge), BD PROCHOT sur Intel (batterie, chargeur, port, capteur ; réinitialisation SMC) ou pas de limitation du tout.
    • Ralentissements délibérés pour économiser l'énergie : scripts/dethrottle.sh signale le mode basse consommation par source d'alimentation, App Nap et la limitation du disque en arrière-plan ; --apply désactive ceux choisis avec une confirmation o/N pour chacun, --undo restaure. Ce sont les seules « désactivations de limitation » que la compétence effectue. La gestion de la santé de la batterie ne modifie que la charge, pas la vitesse du CPU (Apple).
    • Plantages répétés (section 8 du diagnostic) : scripts/crash-report.sh (30 pour 30 jours) nomme le propriétaire de chaque processus qui plante : application, assistant, extension d'application (Quick Look, vignette, partage) ou une partie de macOS et l'application pour laquelle il travaillait ; si le programme est toujours installé ; et quoi faire. Les rapports de ressource (utilisation CPU, écritures disque) sont listés séparément des plantages.
    • Un démon qui plante toutes les quelques minutes (ReportCrash/coresymbolicationd occupé, nombreux fichiers .ips pour un même processus) : lisez la trace d'appel.
  4. Demandez. Une question par sujet avec les tailles et une option recommandée (simulateurs, modèles, anciennes données d'applications, caches, assistants). Utilisez la sélection multiple.
  5. Écrivez les scripts de correction avec les modèles de references/fix-patterns.md : numérotés, un correctif chacun, o/N par groupe, Corbeille et non pas rm, tailles affichées d'abord. Exécutez bash -n et shellcheck sur chacun.
  6. Vérifiez. Écrivez une vérification en lecture seule que chaque élément supprimé a disparu et que chaque tâche a été déchargée, comparez l'espace libre avec la référence, puis redémarrez et relancez diagnose.sh. La deuxième passe détecte ce que la première a manqué.
  7. README dans le dossier de l'utilisateur : tableau des résultats, ce qui va bien, ce qu'il a gardé, ordre d'exécution, ce qui a été appliqué, gain attendu.

iCloud presque plein

  1. scripts/icloud-report.sh (accès complet au disque nécessaire) : iCloud Drive par dossier (taille cloud), Photos par type et année avec les plus grandes vidéos et captures d'écran, pièces jointes Messages, Mail.
  2. Demandez une capture d'écran de Réglages Système > [Nom de l'utilisateur] > iCloud > Gérer. Les sauvegardes et données des applications qui ne sont pas sur le Mac ne sont visibles qu'à cet endroit.
  3. Planifiez avec l'utilisateur. Leviers habituels : grandes vidéos et vieilles captures d'écran vers un disque externe, vieilles sauvegardes d'appareils, grandes applications exclues de la sauvegarde iPhone, sauvegarde WhatsApp sans vidéos, grandes pièces jointes Messages. Mentionnez le plan plus large comme alternative honnête lorsque la bibliothèque grandit plus vite que le nettoyage ne libère.
  4. Déchargement des photos (nécessite BACKUP_DIR, par ex. /Volumes/MonDisque/sauvegarde-icloud) :
    • scripts/photos-albums-verify.sh albums videos|screenshots|years ... crée un album par année (rien n'est téléchargé ni supprimé).
    • L'utilisateur exporte chaque album depuis Photos (Exporter l'original non modifié). N'utilisez pas osxphotos pour télécharger depuis iCloud ; voir les pièges.
    • ... verify <kind> liste les albums entièrement sur le disque ; ... retry <kind> crée des albums des éléments manquants uniquement.
    • scripts/photos-delete-verified.sh <kind> supprime uniquement les éléments dont le fichier sur le disque a le même nom et la même taille en octets, via PhotoKit, dans la Corbeille (30 jours). L'utilisateur vide la Corbeille pour libérer iCloud.
    • Téléchargements échouant avec -1009 ou très lents : scripts/network-check.sh ; utilisez une connexion filaire, un album à la fois, scripts/keep-awake.sh pendant les exportations longues (--undo ensuite).
  5. Données d'application dans iCloud (par exemple applications de notes) : elles peuvent résider dans CloudKit, pas dans des fichiers. Exportez depuis l'application avant de la supprimer dans Gérer le stockage.

À lire avant d'écrire des correctifs

  • references/pitfalls.md : ce qui s'est mal passé lors de sessions réelles (commandes bloquées, benchmarks trompeurs, pièges de du, la boucle de plantage répétée, dépassements de temps de osxphotos, exports nocturnes sur Wi-Fi) et ce qui a fonctionné à la place.
  • references/fix-patterns.md : modèles de script pour déplacements vers la Corbeille, éléments launchd, paramètres avec --undo, simulateurs, correctifs par clic uniquement, passes de vérification.

Skills associés