CommunityRédaction et éditiongithub.com

DerrickZeng33/find-files-with-everything-cli

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

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

Cette compétence permet aux agents IA, tels que Claude Code, Codex, et Cursor, d'effectuer des recherches de fichiers extrêmement rapides sur Windows en exploitant le moteur d'indexation Everything via son exécutable en ligne de commande `es.exe`. Elle est particulièrement utile lorsque l'emplacement du fichier est inconnu, en dehors de l'espace de travail, ou lorsqu'une recherche basée sur des métadonnées indexées (comme la date de modification, la taille, ou l'extension) est nécessaire. La compétence guide l'agent pour utiliser `es.exe` de manière efficiente : elle préconise des requêtes ciblées avec un nombre limité de résultats (20 par défaut), l'emploi de filtres tels que `-path` et des termes spécifiques d'Everything, et l'utilisation du format JSON uniquement si des métadonnées structurées sont requises. Elle insiste sur la nature lecture seule des recherches, interdisant toute modification d'état ou action sur les fichiers, et fournit des instructions claires pour signaler les résultats de manière concise.

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

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

Rechercher des fichiers avec Everything

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

Orienter 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 de l'ordinateur, 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 ayant échoué :

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    Sinon, exécutez la recherche directement. Si ES est manquant ou renvoie une erreur IPC 8, utilisez une solution de repli étroitement ciblée. N'installez pas, ne démarrez pas, ne réparez pas de logiciel sauf demande explicite de l'utilisateur.

  2. Limitez la requête avant d'augmenter le nombre de résultats :

    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 les 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 simples 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 importe ou qu'une requête limitée nécessite un affinage.

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

Signaler 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 un résultat de recherche zéro 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 ; il n'est pas indexé par défaut et est généralement moins efficace que rg.

Maintenir les recherches en lecture seule

N'utilisez pas les options de modification d'état d'ES telles que -exit, -reindex, -save-db, les modificateurs de compteur d'exécution, ou les changements de paramètres enregistrés. Ne supprimez, déplacez, copiez ou n'ouvrez pas les résultats sauf si l'utilisateur en fait explicitement la demande.

Skills associés