Skip to content

Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026. To learn more, see our blog post.

Gemini CLI has not been optimized for Gemini 4 Argon. To use Gemini 4 Argon, please use Antigravity.

Gemini CLI Icon Gemini CLI

Memory files

Gemini CLI persists durable facts, user preferences, and project details by editing Markdown memory files directly.

Technical reference

Section titled “Technical reference”

The agent routes memories to the appropriate Markdown file: shared project instructions go in repository GEMINI.md files, private project notes go in the per-project private memory folder, and cross-project personal preferences go in the global ~/.gemini/GEMINI.md file.

Technical behavior

Section titled “Technical behavior”
  • Storage: Edits Markdown files with write_file or replace.
  • Loading: The stored facts are automatically included in the hierarchical context system for all future sessions.
  • Format: Keeps durable instructions concise and avoids duplicating the same fact across multiple memory tiers.

Use cases

Section titled “Use cases”
  • Persisting user preferences (for example, “I prefer functional programming”).
  • Saving project-wide architectural decisions.
  • Storing frequently used aliases or system configurations.

Next steps

Section titled “Next steps”
Last updated: