GEMINI.md in Gemini CLI: context file locations, imports and /memory

Gemini CLI loads context files in a fixed order and concatenates them.

• Global: ~/.gemini/GEMINI.md applies to all your projects.
• Workspace: GEMINI.md files in your configured workspace directories and their parent directories.
• Just in time: when a tool reads a file or folder, the CLI scans that folder and its ancestors, up to a trusted root, for more GEMINI.md files.
• The CLI footer shows how many context files are loaded.

Create GEMINI.md at your project root with plain Markdown instructions.

# Project: My TypeScript Library

## General Instructions

- When you generate new TypeScript code, follow the existing coding style.
- Ensure all new functions and classes have JSDoc comments.

## Coding Style

- Use 2 spaces for indentation.
- Always use strict equality (=== and !==).

Import other Markdown files with the @file.md syntax. Relative and absolute paths both work.

# Main GEMINI.md file

This is the main content.

@./components/instructions.md

@../shared/style-guide.md

• /memory show prints the full concatenated context the model receives.
• /memory reload rescans and reloads every GEMINI.md file.

/memory show
/memory reload

Set context.fileName in settings.json to a name or a list of names. This lets Gemini CLI read AGENTS.md files too.

{
  "context": {
    "fileName": ["AGENTS.md", "CONTEXT.md", "GEMINI.md"]
  }
}

Note: the Gemini CLI docs say unpaid tier and Google One users had Gemini CLI replaced by Antigravity CLI on June 18, 2026.