Explorer un codebase avec Vibe

Le scan automatique du projet

Dès que vous lancez Vibe dans un répertoire, l’agent effectue un scan automatique de votre projet, et ce travail a lieu avant même que vous ayez tapé votre premier message. Il relève l’arborescence des fichiers — structure des dossiers, fichiers principaux, fichiers de configuration —, puis le statut Git avec la branch active, les fichiers modifiés, les fichiers non suivis et le dernier commit. Il identifie ensuite le type de projet grâce aux fichiers de configuration présents (package.json, pyproject.toml, Cargo.toml, etc.) et lit ces manifestes pour connaître les dépendances déclarées.

Ce contexte est injecté dans la conversation dès l’ouverture. La conséquence est très concrète : ouvrez Vibe dans un dépôt que vous n’avez jamais vu, demandez « Quelle est l’architecture de ce projet ? », et l’agent répond immédiatement, parce qu’il n’a rien à aller chercher — l’arborescence et les manifestes sont déjà sous ses yeux.

Naviguer dans le code

Dans un projet inconnu, la première question est presque toujours celle de la structure d’ensemble. Formulez-la simplement :

Donne-moi une vue d'ensemble de ce projet. Quels sont les fichiers principaux et comment sont-ils organisés ?

Vibe parcourt les répertoires, ouvre les fichiers clés — README, configuration, points d’entrée — et vous rend une synthèse. À partir de là, vous pouvez chercher précisément. Pour retrouver une fonction, une variable ou un motif dans le code, l’agent s’appuie en arrière-plan sur grep et ripgrep ; il choisit lui-même l’outil le plus efficace et privilégie ripgrep sur les projets volumineux, pour la rapidité. Les questions se posent en langage naturel :

Où est définie la fonction handleAuthentication ?

Trouve tous les fichiers qui importent le module database

Quels endpoints utilisent le middleware rateLimiter ?

Quand vous savez déjà quel fichier vous intéresse, dirigez l’attention de l’agent avec le préfixe @, épaulé par l’autocomplétion :

Explique-moi le code dans @src/api/routes/auth.ts

Rien ne vous limite à une seule référence par message, ce qui rend les comparaisons directes très naturelles :

Compare @src/old/handler.py et @src/new/handler.py, quelles sont les différences ?

Le contexte Git, lu en temps réel

Parce que Vibe suit l’état du dépôt pendant la session, vous pouvez l’interroger sur votre travail en cours plutôt que sur le code figé. Demandez-lui quels fichiers ont été modifiés depuis le dernier commit, faites-lui résumer les changements de la branch feature/auth par rapport à main, ou repérez les fichiers non suivis qui mériteraient d’entrer dans le .gitignore. Dans chaque cas, l’agent exécute lui-même les commandes nécessaires — git status, git diff, git log — et vous en restitue le résultat sous une forme lisible, sans que vous ayez à décoder une sortie brute.

La même logique s’applique aux dépendances. Une question du type « Quelles sont les dépendances principales de ce projet ? Y en a-t-il d’obsolètes ? » amène l’agent à lire le package.json, le pyproject.toml ou l’équivalent de votre écosystème. Et si un serveur MCP de fetch est configuré, il peut même vérifier les versions réellement disponibles pour répondre à « Ce projet utilise-t-il une version récente de React ? ».

Creuser par la conversation

Le véritable intérêt de Vibe pour l’exploration tient au caractère conversationnel de l’échange : chaque réponse ouvre la question suivante, plus précise.

> Explique la structure du dossier src/services/
< Le dossier contient 5 services : auth, email, payment, storage et notification...

> Détaille le service payment, comment gère-t-il les webhooks ?
< Le service payment utilise Stripe avec un handler de webhooks dans payment/webhooks.ts...

> Montre-moi le code du handler de webhooks
< [Affiche le contenu du fichier]

Cette approche itérative va souvent plus vite qu’une recherche manuelle dans l’éditeur, précisément dans le cas où vous êtes le moins outillé : quand vous ne connaissez pas encore la codebase et que vous ne savez donc pas quoi chercher.

Explorer sans risque avec le mode Plan

Auditer du code tiers ou fouiller un projet sensible pose une question légitime : et si l’agent modifiait quelque chose ? Le mode Plan, que vous activez avec Shift+Tab, répond à ce doute en restreignant les capacités de Vibe à la seule lecture.

Prenez le réflexe de basculer en mode Plan avant toute revue de code que vous n’avez pas vous-même écrit : vous gardez tout le confort d’exploration décrit plus haut, sans aucune possibilité d’effet de bord.

Points clés à retenir

• Vibe scanne automatiquement l’arborescence, le statut Git et les dépendances au lancement
• Le préfixe @ permet de référencer des fichiers spécifiques avec autocomplétion
• Les recherches dans le code utilisent grep/ripgrep en arrière-plan
• L’exploration conversationnelle permet de creuser progressivement dans le code
• Le mode Plan (Shift+Tab) garantit une exploration en lecture seule