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. Ce scan collecte plusieurs informations essentielles sans que vous ayez besoin de les fournir :

• L’arborescence des fichiers — structure des dossiers, fichiers principaux, fichiers de configuration
• Le statut Git — branch active, fichiers modifiés, fichiers non suivis, dernier commit
• Le type de projet — détection automatique via les fichiers de configuration (package.json, pyproject.toml, Cargo.toml, etc.)
• Les dépendances — lecture des manifestes pour identifier les bibliothèques utilisées

Ce contexte est injecté dans la conversation avant même votre premier message. C’est pour cela que Vibe peut répondre précisément à des questions comme « Quelle est l’architecture de ce projet ? » sans qu’il ait besoin de chercher manuellement.

Naviguer dans le code

Demander une vue d’ensemble

La première chose à faire dans un nouveau projet est souvent de comprendre sa structure :

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

Vibe analysera les répertoires, lira les fichiers clés (README, configuration, points d’entrée) et vous fournira une synthèse.

Rechercher du code spécifique

Pour retrouver une fonction, une variable ou un pattern dans le code, Vibe utilise grep et ripgrep en arrière-plan :

Où est définie la fonction handleAuthentication ?

Trouve tous les fichiers qui importent le module database

Quels endpoints utilisent le middleware rateLimiter ?

L’agent choisit automatiquement l’outil de recherche le plus efficace. Pour les projets volumineux, ripgrep est privilégié pour sa rapidité.

Référencer des fichiers avec @

Pour diriger l’attention de Vibe vers un fichier précis, utilisez le préfixe @ :

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

L’autocomplétion vous aide à trouver le bon chemin. Vous pouvez référencer plusieurs fichiers dans un même message :

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

Comprendre le contexte Git

Vibe lit le statut Git en temps réel, ce qui permet des questions contextuelles :

Quels fichiers ont été modifiés depuis le dernier commit ?

Résume les changements de la branch feature/auth par rapport à main

Y a-t-il des fichiers non suivis qui devraient être ajoutés au .gitignore ?

L’agent exécute les commandes Git nécessaires (git status, git diff, git log) et vous présente les résultats de manière lisible.

Analyser les dépendances

Vibe peut lire les fichiers de dépendances et vous aider à comprendre votre stack :

Quelles sont les dépendances principales de ce projet ? Y en a-t-il d'obsolètes ?

Ce projet utilise-t-il une version récente de React ?

L’agent lit le package.json, pyproject.toml ou équivalent et peut même vérifier les versions disponibles si un serveur MCP de fetch est configuré.

Exploration interactive

L’un des avantages de Vibe est la possibilité d’explorer de manière conversationnelle. Chaque réponse peut mener à une question 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 est souvent plus efficace qu’une recherche manuelle dans l’éditeur, surtout quand vous ne connaissez pas encore la codebase.

Le mode Plan pour l’exploration sécurisée

Si vous explorez un projet sensible et souhaitez être certain que Vibe ne modifie rien, activez le mode Plan avec Shift+Tab :

En mode Plan, l’agent peut :

• Lire des fichiers
• Chercher dans le code
• Analyser la structure du projet

Mais il ne peut pas :

• Écrire ou modifier des fichiers
• Exécuter des commandes shell
• Créer de nouveaux fichiers

C’est le mode idéal pour faire de l’audit de code ou explorer un projet tiers en toute sécurité.

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