GEMINI.mdGEMINI.md (Gemini CLI): dónde se encuentra y cómo lo leen las herramientas
GEMINI.md es el archivo de contexto que Gemini CLI envía con cada prompt. También puede leer AGENTS.md o cualquier otro nombre que configures en context.fileName.
Dónde se encuentra
- Global: ~/.gemini/GEMINI.md.
- GEMINI.md en los directorios del espacio de trabajo y sus directorios superiores.
- GEMINI.md que se encuentran en el momento en directorios a los que acceden las herramientas, y en sus directorios superiores hasta una raíz de confianza.
Formato
Markdown sin frontmatter. Incluye otros archivos con @file.md, mediante rutas relativas o absolutas, a través del Memory Import Processor. El nombre del archivo se configura en context.fileName, como una cadena o una lista.
# Project context
@./docs/architecture.md
## Commands
- Install: `uv sync`
- Test: `uv run pytest`
- Lint: `uv run ruff check .`
## Rules
- Target Python 3.13 with type hints on public functions.
- Keep database code in app/db/.
- Never run migrations against production.
Precedencia y combinación
Los archivos se cargan en este orden: global, luego los del espacio de trabajo y sus directorios superiores, y por último los que se encuentran en el momento. Todos se concatenan y se envían con cada prompt, así que no se sobrescribe ninguno.
Herramientas que lo leen
| Herramienta | Compatibilidad |
|---|---|
| Gemini CLI | Compatibilidad nativa. Cambia el nombre del archivo o añade AGENTS.md mediante context.fileName; /memory show y /memory reload permiten consultarlo. |
| GitHub Copilot | Lee un GEMINI.md en la raíz como instrucciones para el agente, como alternativa a AGENTS.md. |
Consejos
- Configura context.fileName como ["AGENTS.md", "GEMINI.md"] en .gemini/settings.json para compartir un archivo con otros agentes.
- Cada archivo cargado se incluye en todos los prompt, así que elimina lo que el modelo no necesite en cada ocasión.
- Usa /memory show para ver exactamente qué ha cargado Gemini CLI y /memory reload después de editarlo.
Genera un AGENTS.md y los archivos de reglas correspondientes para cinco herramientas desde un único formulario. Abrir el generador de AGENTS.md →