GEMINI.mdGEMINI.md (Gemini CLI): расположение и чтение инструментами
GEMINI.md — файл контекста, который Gemini CLI отправляет с каждым prompt. Можно также использовать AGENTS.md или любое другое имя, заданное в context.fileName.
Расположение
- Глобальный файл: ~/.gemini/GEMINI.md.
- GEMINI.md в каталогах рабочей области и их родительских каталогах.
- GEMINI.md, найденные по мере необходимости в каталогах, к которым обращаются инструменты, и в их родительских каталогах вплоть до доверенного корня.
Формат
Markdown без frontmatter. Подключайте другие файлы с помощью @file.md, указывая относительный или абсолютный путь. Для этого используется Memory Import Processor. Имя файла настраивается через context.fileName: можно указать строку или список.
# 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.
Приоритет и объединение
Файлы загружаются в таком порядке: глобальный, затем файлы рабочей области и родительских каталогов, затем файлы, найденные по мере необходимости. Все они объединяются и отправляются с каждым prompt, поэтому ничего не переопределяется.
Инструменты, которые его читают
| Инструмент | Поддержка |
|---|---|
| Gemini CLI | Поддерживается нативно. Переименуйте файл или добавьте AGENTS.md через context.fileName. Просмотреть его можно с помощью /memory show, а перечитать — с помощью /memory reload. |
| GitHub Copilot | Читает корневой GEMINI.md как файл с инструкциями для агента — в качестве альтернативы AGENTS.md. |
Советы
- Задайте context.fileName как ["AGENTS.md", "GEMINI.md"] в .gemini/settings.json, чтобы использовать один файл совместно с другими агентами.
- Каждый загруженный файл добавляется к каждому prompt, поэтому удалите всё, что модели не нужно при каждом запросе.
- Выполните /memory show, чтобы увидеть, что именно загрузил Gemini CLI, а после редактирования — /memory reload.
Создайте AGENTS.md и соответствующие файлы правил для пяти инструментов с помощью одной формы. Открыть генератор AGENTS.md →