zvec-grep (zg) : Radar de code et de documentation
zvec-grep (abrégé en zg) est un outil de recherche conçu pour les humains et les assistants IA. Contrairement aux anciens outils qui ne cherchent que des correspondances littérales lettre par lettre, zg comprend ce que vous voulez dire et indique exactement dans quel fichier et à quelles lignes se trouve le sujet recherché.
La métaphore de la bibliothèque : Pourquoi en avons-nous besoin ?
Pensez à la recherche d'une ancienne conversation sur votre téléphone :
- Vous vous souvenez vaguement avoir discuté de « où aller manger samedi soir », mais vous ne vous rappelez plus des termes exacts.
- Un outil classique (comme
grep) fonctionne comme une loupe mot à mot : si vous cherchez « restaurant » mais que vous aviez écrit « pizzeria », la recherche classique ne trouve rien. - Pour pallier cela, les premiers assistants IA adoptaient la méthode brutale : ils posaient sur leur bureau une vingtaine de classeurs de 500 pages et lisaient tout de A à Z.
- Résultat : une indigestion d'informations. La mémoire immédiate de l'IA débordait. Elle oubliait les consignes initiales et commençait à coder des usines à gaz incontrôlables que personne n'avait demandées.
La solution : La fiche d'index intelligente
zvec-grep agit comme un bibliothécaire qui connaît par cœur le sommaire de chaque cahier :
- Vous demandez en langage naturel : « Où calcule-t-on les frais d'exécution ? »
zgne déverse pas toute la bibliothèque sur le bureau de l'IA. Il lui tend une petite fiche :
matching.py : lignes 148 à 253 (match_fifo_lots)- L'IA lit strictement ces 100 lignes, applique la modification demandée et s'arrête immédiatement.
Ce que vous y gagnez concrètement
| Sans zg (Lecture brute massive) | Avec zg (Radar de précision) |
|---|---|
| Saturation de la mémoire : Lecture de 3 gros fichiers (~5 000 mots), épuisant rapidement l'attention de l'IA. | Concentration chirurgicale : Renvoie uniquement le fichier et les numéros de ligne (~80 mots). |
| Dérive incontrôlée : En perdant le fil, l'IA invente des fonctionnalités superflues non demandées. | Discipline absolue : La mémoire reste nette, l'IA se limite strictement au point à corriger. |
| Doublons partout : Faute de trouver les notes existantes, l'IA crée des pages redondantes. | Source unique de vérité : Localise immédiatement la page existante pour la compléter sur place. |
| Lenteur et surcoût : Transférer de volumineux blocs de code consomme du temps et des frais d'API. | 100 % local et rapide : S'exécute en quelques secondes sur votre processeur, sans envoyer votre code sur le cloud. |
Les 3 commandes essentielles au quotidien
À exécuter dans votre terminal à la racine du projet :
1. Construire l'index de recherche (première utilisation)
# Projets de programmation (Python, JavaScript...)
npx @zvec/zvec-grep index --embedding local/potion-code-16m-v2
# Jardins documentaires multilingues (comme ce site)
npx @zvec/zvec-grep index --embedding local/potion-multilingual-128m
2. Trouver de la logique métier dans le code
npx @zvec/zvec-grep query "order execution slippage commission fee" -g '*.py' --limit 3 --human
3. Vérifier les doublons avant d'écrire une note
npx @zvec/zvec-grep query "personal knowledge system" -g 'docs/**' --limit 3
Si une note existe déjà, enrichissez-la directement au lieu de créer un second document isolé.
Écosystème associé
- Vue d'ensemble : Mémoire des agents et récupération hiérarchique — La place de
zgdans la pyramide cognitive à 4 niveaux. - Le gardien des règles : Basic Memory — Alors que
zgpointe le code,Basic Memoryfixe les consignes et les lignes rouges. - Le jardin conceptuel : QMD — Le moteur de recherche pour vos notes de théories et d'architecture.
Ressources officielles et références
- Dépôt GitHub : zvec-ai/zvec-grep
- Paquet officiel NPM : @zvec/zvec-grep