AI Tool Atlas
Règles et instructions Officiel

GEMINI.md

Fichiers de contexte GEMINI.md donnant à Gemini CLI instructions de projet à chaque prompt.

Auteur
Google
Compatible avec
Gemini CLI
Licence
Apache-2.0
Documenté
Oct 2, 2026
Dépôt ↗ Documentation officielle ↗

Ce qu'est GEMINI.md

Les fichiers de contexte GEMINI.md fournissent un contexte instructif au modèle Gemini pour que vous ne répétiez pas les instructions dans chaque prompt. Gemini CLI charge des fichiers globaux, d'espace de travail et à la volée, les concatène et les envoie avec chaque prompt.

Ce qu'il fait

Comment GEMINI.md s'intègre : quels agents l'exécutent et ce qu'il ajouteS'EXÉCUTE DANSVotre agentGemini CLIun hôte documentéRULES · OFFICIELGEMINI.mdInstructions de projet lues par l…5 étapes d'installationaucune autorisation supplémentair…licence : Apache-2.0CE QU'IL AJOUTECe qu'il faitCharge le contexte global depuis…Cherche GEMINI.md dans les répert…Charge des fichiers GEMINI.md à l…Importe d'autres fichiers avec la…agent → extension → nouvelle capacité · depuis le dépôt ou la documentation officielle
Où GEMINI.md s'exécute et ce qu'il ajoute, d'après sa documentation
  • Charge le contexte global depuis ~/.gemini/GEMINI.md
  • Cherche GEMINI.md dans les répertoires de l'espace de travail et leurs parents
  • Charge des fichiers GEMINI.md à la volée quand un outil accède à un répertoire
  • Importe d'autres fichiers avec la syntaxe @file.md
  • /memory show et /memory reload inspectent et actualisent le contexte chargé
  • Nom de fichier configurable via context.fileName dans settings.json

Quand l'utiliser

Bonne adéquation

  • Vous voulez que le style de code et les instructions du projet s'appliquent à chaque prompt de Gemini CLI
  • Vous voulez que des instructions propres à un composant ne soient chargées que lorsqu'elles sont pertinentes
  • Vous voulez un seul jeu d'instructions partagé via un nom de fichier personnalisé comme AGENTS.md

Pas pour

  • Enregistrer des faits individuels à la demande : la doc renvoie vers l'outil Memory

Comment installer GEMINI.md

Il vous faut : Gemini CLI

  1. Créez GEMINI.md à la racine du projet (ou ~/.gemini/GEMINI.md pour le global)
  2. Ajoutez des instructions générales et le style de code en markdown
  3. Importez éventuellement des fichiers avec @./components/instructions.md
  4. Exécutez /memory show pour inspecter le contexte chargé
  5. Définissez éventuellement context.fileName dans settings.json
Exemple de configuration (tiré de la documentation officielle)
{
  "context": {
    "fileName": ["AGENTS.md", "CONTEXT.md", "GEMINI.md"]
  }
}

Limites

  • Tous les fichiers trouvés sont concaténés et envoyés avec chaque prompt, donc leur taille pèse sur le contexte

Outils qu'il étend

Questions fréquentes

Où Gemini CLI cherche-t-il GEMINI.md ?

~/.gemini/GEMINI.md, les répertoires de l'espace de travail et leurs parents, et à la volée dans les répertoires auxquels les outils accèdent. source

GEMINI.md peut-il importer d'autres fichiers ?

Oui, avec la syntaxe @file.md en chemins relatifs ou absolus. source

Gemini CLI peut-il utiliser AGENTS.md au lieu de GEMINI.md ?

Oui, définissez context.fileName dans settings.json avec une liste comme AGENTS.md, CONTEXT.md, GEMINI.md. source

Comment voir quel contexte GEMINI.md est chargé ?

Exécutez /memory show ; /memory reload réanalyse les fichiers. source

Sources et lacunes

Autres extensions à découvrir