Los archivos de contexto GEMINI.md aportan contexto instructivo al modelo Gemini para que no repitas instrucciones en cada prompt. Gemini CLI carga archivos globales, de espacio de trabajo y just-in-time, los concatena y los envía con cada prompt.
Qué hace
Dónde se ejecuta GEMINI.md y qué añade, según su documentación
Carga el contexto global desde ~/.gemini/GEMINI.md
Busca GEMINI.md en los directorios del espacio de trabajo y sus padres
Carga archivos GEMINI.md just-in-time cuando una herramienta accede a un directorio
Importa otros archivos con la sintaxis @file.md
/memory show y /memory reload inspeccionan y actualizan el contexto cargado
El nombre del archivo es configurable con context.fileName en settings.json
Cuándo usarla
Buen encaje
Quieres que el estilo de código y las instrucciones del proyecto se apliquen a cada prompt de Gemini CLI
Quieres instrucciones específicas de un componente cargadas solo cuando sean relevantes
Quieres un solo conjunto de instrucciones compartidas con un nombre de archivo personalizado como AGENTS.md
No apto para
Guardar datos individuales bajo demanda: la documentación apunta a la herramienta Memory
Cómo instalar GEMINI.md
Necesitas: Gemini CLI
Crea GEMINI.md en la raíz del proyecto (o ~/.gemini/GEMINI.md para el global)
Añade instrucciones generales y estilo de código en markdown
Opcionalmente importa archivos con @./components/instructions.md
Ejecuta /memory show para inspeccionar el contexto cargado
Opcionalmente define context.fileName en settings.json
Ejemplo de configuración (de la documentación oficial)
En ~/.gemini/GEMINI.md, los directorios del espacio de trabajo y sus padres, y just-in-time en los directorios a los que acceden las herramientas. fuente
¿GEMINI.md puede importar otros archivos?
Sí, con la sintaxis @file.md usando rutas relativas o absolutas. fuente
¿Gemini CLI puede usar AGENTS.md en lugar de GEMINI.md?
Sí, define context.fileName en settings.json con una lista como AGENTS.md, CONTEXT.md, GEMINI.md. fuente
¿Cómo veo qué contexto de GEMINI.md está cargado?
Ejecuta /memory show; /memory reload vuelve a analizar los archivos. fuente
