Source: GEMINI.md context files (Gemini CLI docs)
How Gemini CLI loads hierarchical GEMINI.md files (global, workspace ancestors, just-in-time), supports @imports, and can be pointed at AGENTS.md.
Contents
- What: official product documentation
- Publisher: Google (Gemini CLI project)
- Date: living document, read 2026-11-14
- Original: Provide context with GEMINI.md files
Summary
Gemini CLI’s equivalent of CLAUDE.md/AGENTS.md. Note a 2026-06-18 banner: Gemini CLI was replaced by Antigravity CLI for unpaid and Google One users.
Key claims
- All found files are concatenated and sent with every prompt.
- Order: global
~/.gemini/GEMINI.md; then workspace directories and their parents; then just-in-time loading when a tool touches a directory (scanning it and its ancestors up to a trusted root). /memory showprints the concatenated context;/memory reloadrescans.@file.mdimports split large files (relative or absolute paths).context.fileNamein settings accepts a name or list, e.g.["AGENTS.md", "GEMINI.md"], so one file can serve several agents.- No size limits are stated;
.geminiignoreexcludes files from context.