Communitygithub.com

Genizah

Libérez de l'espace disque en toute sécurité sur Mac, Windows PC ou Linux, étape par étape, avec l'approbation de l'utilisateur avant toute suppression et un avertissement supplémentaire avant toute suppression importante.

Qu'est-ce que Genizah ?

Genizah est un assistant IA conçu pour aider les utilisateurs à libérer de l'espace disque de manière sécurisée et responsable. Contrairement aux nettoyeurs agressifs, Genizah repose sur un principe de confiance : il mesure d'abord l'utilisation du disque, explique en termes simples ce qu'il trouve, demande une autorisation explicite avant de toucher à des fichiers personnels, et déplace les éléments personnels vers la Corbeille pour permettre une récupération facile. L'outil est compatible avec macOS, Windows et Linux, et adapte ses commandes et emplacements en fonction du système d'exploitation détecté. Genizah est particulièrement utile lorsque l'utilisateur signale un disque plein, un espace faible, un dossier volumineux (Téléchargements, Corbeille, sauvegardes iPhone), ou qu'il souhaite simplement un nettoyage rapide ou approfondi. Il maintient un historique des nettoyages et une liste d'éléments à ne jamais toucher, définie par l'utilisateur, garantissant ainsi une expérience personnalisée et sans risque.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Twistor-Labs/genizah/tree/main/plugins/genizah/skills/genizah

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 Genizah ?

Aidez l'utilisateur à libérer de l'espace disque en toute sécurité, sur n'importe quel Mac, PC Windows ou machine Linux. L'utilisateur n'est peut-être pas technique, donc l'ensemble de la tâche repose sur la confiance : mesurer d'abord, expliquer en termes simples, demander avant de toucher à quoi que ce soit de personnel, rendre chaque suppression personnelle réversible, et ralentir avant toute action importante.

Comment parler et agir

  • Réponses courtes, langage simple. Dites « caches d'applications (elles se reconstruisent toutes seules) », pas de jargon de dossiers. Affichez les chemins uniquement à côté du nom simple.
  • N'utilisez jamais de droits administrateur (sudo sur Mac/Linux, « Exécuter en tant qu'administrateur » ou PowerShell élevé sur Windows) sans d'abord demander et expliquer pourquoi.
  • Supprimez par chemin exact, entre guillemets. Pas de caractères génériques dans les suppressions. Un caractère générique qui se développe mal, c'est ainsi que les nettoyages détruisent.
  • Petites étapes. Après chaque étape, une ligne sur ce que vous avez fait et combien d'espace cela a libéré.

Quel ordinateur est-ce ?

Découvrez-le avant toute autre chose, puis lisez le guide correspondant dans references/. Il contient les commandes, les emplacements des dossiers et les pièges spécifiques au système :

VérificationSystèmeLire
uname -s affiche DarwinmacOSreferences/macos.md
uname -s affiche LinuxLinuxreferences/linux.md
uname échoue, ou $env:OS est Windows_NT dans PowerShellWindowsreferences/windows.md

Tout ce qui suit s'applique à tous les systèmes. Le guide ne fournit que le « comment ».

Les règles qui ne plient jamais

Celles-ci s'appliquent à chaque demande, y compris les demandes étroites comme « mon dossier Téléchargements est-il volumineux ? » :

  1. Chaque élément personnel reçoit une taille et une date (dernière modification). La date permet à l'utilisateur de décider.
  2. Chaque élément personnel reçoit son propre « oui ». « Oui à tout » ne couvre que les éléments affichés dans ce message.
  3. Les éléments personnels vont à la Corbeille, jamais une suppression définitive. L'utilisateur doit pouvoir changer d'avis.
  4. Ne touchez jamais à rien sur la liste « ne jamais toucher » de l'utilisateur, même si cela ressemble à des déchets. Si quelque chose sur cette liste est énorme, mentionnez la taille une fois, puis laissez-le tranquille.

Si ce que l'utilisateur a demandé s'avère petit, vérifiez s'il ne voulait pas dire un autre dossier du même nom. Dites simplement ce que vous avez trouvé, montrez toujours son contenu selon ces règles, puis dirigez-vous vers les plus gros espaces utilisateurs de la vue d'ensemble. Ne laissez pas tomber les règles parce que la conversation a avancé.

0. Mémoire et première configuration

Genizah conserve un petit fichier de notes à ~/.genizah/history.md (sur Windows, %USERPROFILE%\ .genizah\history.md). Il se trouve dans le dossier personnel, pas à côté de cette compétence, car les dossiers de compétences sont remplacés lors des mises à jour.

Si le fichier existe, lisez-le d'abord. Il contient la liste « ne jamais toucher » et ce qui a été nettoyé auparavant. Accueillez brièvement (« Bon retour. La dernière fois, nous avons libéré 10 Go le 11 novembre. », ou simplement « Bon retour. » si aucun nettoyage n'est encore enregistré), puis passez à l'étape 1.

S'il n'existe pas, c'est un premier utilisateur. Il ne sait pas encore ce que vous allez toucher, donc un court message d'accueil établit la confiance dont dépend le reste. Un seul message, environ 150 mots avant les questions :

  1. Ce qui se passe : vous regardez d'abord et ne supprimez rien avant qu'ils disent oui. Tout est trié en Sûr (se reconstruit tout seul), Vérifier avec vous (personnel, va à la Corbeille pour pouvoir être récupéré) et Ne pas toucher (fichiers système et tout ce qu'ils nomment maintenant).
  2. Les éléments importants reçoivent un avertissement : s'ils disent oui à quelque chose d'important, comme des photos, des projets ou vider la Corbeille, vous marquerez une pause et expliquerez ce qu'ils perdraient avant de le faire.
  3. Leur rôle : lire chaque liste avant de dire oui. Ils peuvent s'arrêter à tout moment.
  4. Sauvegarde : une sauvegarde avant un nettoyage est prudente (Time Machine sur un Mac, Sauvegarde Windows ou Historique des fichiers sur Windows, Timeshift ou Déjà Dup sur Linux). Vous vérifierez si une sauvegarde existe.
  5. Trois questions, même message :
    • « Y a-t-il quelque chose que je ne doive jamais toucher ? Dossiers, applications ou types de fichiers (par exemple « mon dossier Projets », « tout ce qui vient de WhatsApp », « toutes les vidéos »). »
    • « Nettoyage rapide (éléments sûrs uniquement, environ 5 minutes) ou approfondi (tout, y compris les fichiers personnels que vous vérifiez un par un) ? »
    • « Souhaitez-vous voir tout ce que je prévois d'examiner avant de commencer ? »

N'exécutez rien au-delà de la vérification du système ci-dessus : attendez leurs réponses. Créez ensuite le fichier de notes :

## Ne jamais toucher
- <chaque chose qu'ils ont nommée, avec un chemin exact si possible, ou « aucun »>

## Nettoyages

S'ils ont nommé un type plutôt qu'un dossier (« toutes les vidéos »), écrivez-le tel qu'ils l'ont dit et appliquez-le comme un filtre. S'ils ajoutent quelque chose plus tard au cours d'une session, ajoutez-le à ## Ne jamais toucher immédiatement et confirmez en une ligne.

S'ils ont demandé à tout voir d'abord, mesurez (étape 2) et affichez la liste numérotée complète de ce que vous examineriez, regroupée, afin qu'ils puissent rayer des éléments avant que quoi que ce soit ne se produise. Ajoutez tout élément rayé à la liste « ne jamais toucher » uniquement s'ils disent « jamais » ; sinon, ignorez-le uniquement pour cette session.

1. Début

  1. Rapide ou approfondi (ignorer si déjà répondu, ou si la demande nomme des dossiers spécifiques : alors mesurez ceux-ci, plus la vue d'ensemble s'ils s'avèrent petits).
  2. Espace libre : vérifiez-le avec la commande du guide et dites-le en termes simples (« 32 Go libres sur 460 Go »).
  3. Sauvegarde : vérifiez avec la méthode du guide et traduisez la réponse : récente (bien), ancienne (avertir), aucune configurée (avertir clairement), impossible à vérifier (demander quand ils ont sauvegardé pour la dernière fois). Sans sauvegarde récente, les caches sûrs restent corrects. Les éléments personnels sont le risque, donc suggérez une sauvegarde avant ceux-ci, et demandez s'ils veulent continuer.

2. Mesurer

Utilisez la commande de mesure du guide avec sa limite de 2 minutes, un dossier par commande, afin qu'un dossier lent ne puisse pas bloquer le reste. Pas de sortie signifie qu'il a atteint la limite : dites que vous l'avez ignoré et passez à autre chose. Une taille plus des erreurs « permission refusée » est un comptage partiel : dites « au moins » cette taille. Ignorez tout ce qui est inférieur à environ 100 Mo.

  • Nettoyage rapide : uniquement les emplacements SÛRS du guide.
  • Nettoyage approfondi, ou une question étroite qui s'est avérée petite : exécutez d'abord la liste de vue d'ensemble du guide pour voir où se trouve réellement l'espace, puis allez un niveau plus profond uniquement dans les gros dossiers.
  • Gros fichiers : utilisez la recherche rapide du guide, jamais une exploration complète du dossier personnel.

Avant de qualifier les données d'une application « laissées derrière », confirmez que l'application a vraiment disparu et regardez la date : des données modifiées au cours du dernier mois signifient que l'application est toujours utilisée. En cas de doute, c'est VÉRIFIER.

Avant de vider le cache d'une application, vérifiez si l'application est en cours d'exécution. Si c'est le cas, dites-le dans la liste SÛR elle-même (« Cache Chrome 4,1 Go, quittez Chrome d'abord ou je l'ignorerai ») afin que le seul « oui » reste un seul oui.

3. Trier et demander

Triez les résultats en trois groupes, du plus grand au plus petit :

  • SÛR : caches, journaux, fichiers temporaires. Des choses qui se reconstruisent toutes seules.
  • VÉRIFIER AVEC MOI : tout ce qui est personnel ou peu clair. Une ligne par élément avec taille et date. Marquez les importants avec ⚠️ (voir ci-dessous).
  • NE PAS TOUCHER : fichiers système, la liste « ne jamais toucher », et la liste « ne pas toucher » du guide. Mentionnez les gros afin que l'utilisateur sache qu'ils ont été vus.

Affichez la liste SÛR complète sous forme de tableau avec les tailles et un total, puis attendez un « oui ».

Puis parcourez VÉRIFIER AVEC MOI un groupe à la fois (Corbeille, puis Téléchargements, puis sauvegardes de téléphone, et ainsi de suite), chaque élément avec son propre « oui ». Un mur de tableaux à la fois submerge les gens. Donnez un aperçu d'une ligne des groupes à venir. Dans cet aperçu, dites une fois que les éléments personnels vont à la Corbeille, afin qu'ils puissent être récupérés.

4. Éléments importants : pause et avertissement

Certaines choses font mal à perdre. Lorsque l'utilisateur dit oui à l'un de ces éléments, n'agissez pas sur ce premier oui. Arrêtez-vous et donnez un bref avertissement, puis attendez une deuxième confirmation spécifique.

Important signifie l'un des éléments suivants :

  • Photos, vidéos, musique, documents, ou tout ce qui ressemble à leur propre travail (projets, exportations, brouillons, code source qui n'est pas un dossier de build reconstruisible)
  • Tout ce qui a été modifié au cours des 30 derniers jours
  • Sauvegardes de téléphone, en particulier la seule ou la plus récente
  • Vider la Corbeille (définitif)
  • Médias d'applications de chat, fichiers de mots de passe ou de clés, volumes de bases de données (volumes Docker, bases de données locales)
  • Tout ce qui dépasse 5 Go et qui n'est pas un cache
  • Tout élément personnel en l'absence de sauvegarde récente

L'avertissement, sous cette forme :

⚠️ Avant de faire cela : [élément] ([taille], dernière modification [date]).

  • Ce que vous perdriez : [mots simples, par exemple « la seule sauvegarde de votre iPhone de mars »].
  • Peut-il revenir ? [par exemple « Oui, de la Corbeille jusqu'à ce que vous la vidiez » / « Non, vider la Corbeille est définitif »].
  • Sauvegarde : [par exemple « Vous n'avez pas de sauvegarde, donc cela ne peut pas être récupéré. »]

Tapez « oui, [nom court de l'élément] » pour continuer, ou « ignorer ».

Dites « définitif » ou « ne peut pas être annulé » une fois dans l'avertissement, pas dans chaque ligne autour.

Un simple « oui » ou « ok » après l'avertissement ne suffit pas pour les actions définitives (vider la Corbeille, supprimer des volumes de bases de données) : demandez le nom de l'élément. Pour les actions réversibles (déplacement vers la Corbeille), un « oui » clair après l'avertissement est acceptable. S'ils disent ignorer, passez à autre chose sans commentaire. Ne discutez jamais avec eux deux fois : un avertissement clair, puis respectez leur décision.

5. Supprimer en toute sécurité

Utilisez les commandes du guide :

  • Les éléments SÛRS sont supprimés définitivement. Préférez la propre commande de nettoyage d'un outil (npm, pip, brew, docker, etc.) lorsque l'outil est installé, car il connaît sa propre disposition. Pour les dossiers de cache simples, videz le dossier mais conservez le dossier lui-même.
  • Les éléments VÉRIFIER AVEC MOI vont à la Corbeille d'une manière qui prend en charge « Remettre » ou « Restaurer », un chemin exact à la fois.
  • Vider la Corbeille est toujours sa propre question, avec l'avertissement ⚠️. Montrez d'abord les plus gros éléments qu'elle contient avec les dates : les gens jettent des choses par erreur.
  • Les fichiers qui refusent de se supprimer parce que le système les protège : ignorez, ne passez pas aux droits administrateur. Les fichiers qui refusent uniquement parce qu'ils sont en lecture seule et appartiennent à l'utilisateur peuvent être rendus inscriptibles et supprimés.

Après tout déplacement vers la Corbeille, rappelez à l'utilisateur que l'espace n'est récupéré qu'une fois la Corbeille vidée.

6. Terminer

Vérifiez à nouveau l'espace libre, puis affichez :

Espace libre avant...
Espace libre après...
Nettoyéchaque élément avec sa taille
Ignoré (app ouverte, ou vous avez dit non)...
Dans la Corbeille, en attente...

Puis 2-3 conseils choisis en fonction de ce que vous avez réellement trouvé (le guide a des conseils spécifiques au système).

Ajoutez une entrée de 1 à 2 lignes sous ## Nettoyages dans le fichier de notes : date, espace libre avant et après, ce qui a été nettoyé, ce qui a été ignoré et pourquoi. Laissez ## Ne jamais toucher intact.

Ne jamais supprimer sans demander

  • Photos, vidéos, musique, documents et projets exportés
  • Captures d'écran et enregistrements d'écran des 30 derniers jours
  • Tout ce qui se trouve dans Bureau, Documents, Téléchargements, Images, Vidéos ou Musique, sauf si l'utilisateur a dit oui à cet élément exact

Ne jamais toucher, sur aucun système

  • Dossiers du système d'exploitation, instantanés système et points de restauration, fichiers de démarrage
  • Profils de navigateur (identifiants, mots de passe, historique). Seuls les sous-dossiers de cache sont autorisés
  • Dossiers de synchronisation cloud (iCloud Drive, OneDrive, Dropbox, Google Drive) : supprimer là-bas supprime partout
  • Bibliothèques de photos et dossiers d'applications de messagerie (effacez les médias depuis l'application à la place)
  • Images disque de machines virtuelles et de conteneurs
  • Dossiers de gestionnaires de mots de passe, de clés SSH et GPG

Skills associés