CommunityRédaction et éditiongithub.com

DerrickZeng33/find-files-with-everything

Découverte rapide de fichiers sur Windows pour Codex, Claude Code et les agents IA compatibles via l'interface en ligne de commande Voidtools Everything.

Qu'est-ce que find-files-with-everything ?

Cette compétence permet à un agent IA (comme Codex, Claude Code, etc.) de découvrir rapidement des fichiers sur un système Windows en utilisant `es.exe`, le client en ligne de commande de l'indexeur Everything. Elle est conçue pour minimiser le nombre d'appels et la quantité de texte retourné, en favorisant des requêtes précises et limitées. Le workflow proposé hiérarchise les méthodes de recherche : d'abord un chemin exact connu via `Test-Path` / `Get-Item`, puis une recherche dans un espace de travail avec `rg --files`, et enfin une recherche étendue via Everything pour les emplacements inconnus, hors espace de travail, ou à l'échelle du disque. La compétence insiste sur l'utilisation de requêtes bien filtrées, un plafond de 20 résultats par défaut, et le respect d'un mode strictement en lecture seule (pas d'installation, de modification de l'index, ou d'actions destructrices). Elle s'applique à tout agent travaillant sous Windows et disposant de Everything.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add DerrickZeng33/find-files-with-everything

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · 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

Trouver des fichiers avec Everything

Utilisez es.exe comme client en lecture seule pour l'index Everything en cours d'exécution. Minimisez les appels d'outils et le texte retourné.

Acheminer la recherche

  1. Utilisez Test-Path ou Get-Item pour un chemin exact connu.
  2. Utilisez rg --files pour les noms de fichiers dans un espace de travail connu et rg pour le contenu dans une arborescence connue.
  3. Utilisez Everything en premier lorsque l'emplacement est inconnu, en dehors de l'espace de travail, à l'échelle du disque, ou basé sur des métadonnées indexées.

Exécuter une requête efficace

  1. Vérifiez la disponibilité au maximum une fois par session, ou après une requête échouée :

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    Sinon, lancez la recherche directement. Si ES est manquant ou renvoie une erreur IPC 8, utilisez un repli à portée étroite. N'installez, ne démarrez, ni ne réparez le logiciel sauf si l'utilisateur le demande.

  2. Affinez la requête avant d'augmenter le résultat :

    es.exe -n 20 "report"
    es.exe -path "C:\Work" /a-d -n 20 "ext:xlsx"
    es.exe -size -dm -n 20 "size:>1gb"
    

    Utilisez /ad pour les dossiers, /a-d pour les fichiers, -path pour une sous-arborescence, et les termes de recherche Everything tels que ext:, size:, dm: et dc:. Mettez entre guillemets les chemins et termes contenant des espaces.

  3. Lors de l'appel depuis PowerShell 7 ou ultérieur, placez -argv en premier. Omettez-le dans Windows PowerShell 5.1 et autres shells.

  4. Renvoyez les chemins bruts par défaut. Utilisez -json et des colonnes supplémentaires uniquement lorsque des métadonnées structurées sont nécessaires. Utilisez -get-result-count uniquement lorsque le nombre est important ou qu'une requête plafonnée a besoin d'être affinée.

  5. Gardez le plafond par défaut à 20. Si le plafond est atteint, affinez la requête avant de demander plus de résultats. N'exportez pas les résultats dans un fichier sauf si demandé.

Rapporter le résultat

  • Renvoyez le plus petit ensemble suffisant de chemins exacts et résumez les correspondances omises.
  • Indiquez la requête ou le périmètre lorsqu'aucun résultat n'est trouvé.
  • Considérez une recherche sans résultat comme une preuve concernant l'index Everything actuel, et non comme la preuve qu'un emplacement non indexé est vide.
  • Évitez content: pour une arborescence de projet connue ; cela n'est pas indexé par défaut et est généralement moins efficace que rg.

Gardez les recherches en lecture seule

N'utilisez pas d'options de es.exe modifiant l'état, telles que -exit, -reindex, -save-db, les modificateurs de compteur d'exécution ou les changements de paramètres sauvegardés. Ne supprimez, déplacez, copiez, ni n'ouvrez les résultats sauf si l'utilisateur le demande séparément.

Skills associés