Skip to content
How it learnsFrom coding sessions, reviews, Slack and docs.Only what fitsEach session gets the few rules its task needs.Pull request reviewEvery PR checked against your team’s rules.Keep it trueA gate, conflicts, disputes and stale rules, handled.HandoffsCarry the work to another session or a teammate.SecurityWhat it sends, what it changes and how to leave.
Engineering teamsOne agent or several: what one person learns, every session uses.PR review onlyInstall the GitHub App. Nothing on anyone’s machine.Teams that mix agentsClaude Code, Cursor, Codex and Copilot, the same rules.On your ownYour corrections follow you across repos, machines and agents.Book a call30 minutes with Roei, if you want a hand. Never required.
DocsPricingSign in
Connect your agents →
For teamsOn your ownPR review onlyHow it learnsOnly what fitsPull request reviewKeep it trueSecurityDocsPricingSign inConnect your agents →
Home/Answers

Answers

Ignores its rule file

  • HTML comments in CLAUDE.md
  • "Read AGENTS.md" does not import
  • Antigravity ignores AGENTS.md
  • Windsurf ignores rules

Rule file too long

  • AGENTS.md too long for Codex
  • Antigravity rule size limit
  • Copilot instructions length
  • Cursor rules too long

Rules drift from the code

  • CLAUDE.md and AGENTS.md drift
  • Directory trees in rule files

Share rules across repos and agents

  • Share CLAUDE.md across repos
  • Share AGENTS.md in Codex
  • Copilot org instructions
  • Gemini CLI and AGENTS.md
  • Share Windsurf rules

Memory between sessions

  • Gemini CLI memory

Answers

Gemini CLI reads AGENTS.md only if context.fileName lists it; Antigravity CLI reads it by default

Published November 18, 2026

Gemini CLI reads only GEMINI.md by default; to make it read the AGENTS.md your Codex, Cursor and Copilot teammates use, set context.fileName in settings.json to a list such as ["AGENTS.md", "GEMINI.md"]. Antigravity CLI, which replaced Gemini CLI for unpaid and Google One accounts on 18 June 2026, reads AGENTS.md and GEMINI.md with no setting.

For Gemini CLI and Antigravity CLI. Vendor facts are from the pages linked below, read on November 18, 2026.

One file for every agent

  • Keep the shared rules in AGENTS.md, the one file Codex, Cursor, Copilot and Antigravity all read.
  • In Gemini CLI, add context.fileName to ~/.gemini/settings.json or the project’s .gemini/settings.json.
  • Or import it: a GEMINI.md line @./AGENTS.md pulls the file in with Gemini CLI’s import syntax.
  • Run /memory show to see the concatenated context, and /memory reload after editing.
  • In Antigravity, both files are combined into the prompt with no stated precedence, so do not keep conflicting copies.
{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

The numbers

MeasureValueSource
Public AGENTS.md files on GitHub1,142,784Harbor study, 18 Oct 2026
Public CLAUDE.md files, for comparison839,680Harbor study, 18 Oct 2026
Gemini CLI replaced by Antigravity CLI18 June 2026, unpaid and Google One accountsGemini CLI docs

Study figures are weighted estimates from 1,935 CLAUDE.md and 1,970 AGENTS.md files sampled from public GitHub repositories on 18 October 2026, with GitHub's own counts for the totals. Every figure is in the study's CSV, and the method is in the study.

What the docs say

  • Gemini CLI: GEMINI.md files: context.fileName in settings.json accepts one name or a list, for example ["AGENTS.md", "CONTEXT.md", "GEMINI.md"]. /memory show displays the concatenated memory; /memory reload re-scans the files.
  • Antigravity: Rules: Workspace rules are AGENTS.md, GEMINI.md or .agents/rules/*.md; AGENTS.md and GEMINI.md take no frontmatter and are always on. Discovered rules are combined into the prompt.

Where Harbor fits

Harbor has no hooks for this agent. Its MCP server can be added to any MCP client, but then the agent has to decide to call it, which is the same weakness as a file it has to choose to open. If this is your main agent, the free fixes above are the answer today.

Read next

  • Why Antigravity CLI skips AGENTS.md
  • AGENTS.md vs CLAUDE.md, every agent
  • Keep rule files in sync
  • Share CLAUDE.md rules across repos with ~/.claude/rules, a symlinked .claude/rules, or a managed CLAUDE.md
  • Codex shares instructions across repos only through ~/.codex/AGENTS.md, one person at a time
  • Copilot organization instructions reach every repo, but only on GitHub.com and in code review
  • Share Windsurf rules across repos with ~/.devin/rules, and with other agents through AGENTS.md
  • Every answer, by agent and problem

Questions

Does Gemini CLI read AGENTS.md?

Not by default. It reads GEMINI.md from ~/.gemini and from your workspace folders and their parents. Set context.fileName to a list such as ["AGENTS.md", "GEMINI.md"] to read AGENTS.md too.

Does Antigravity CLI read AGENTS.md?

Yes. AGENTS.md and GEMINI.md in the folder you start agy in, or a parent up to the repository root, are always-on rules.

Should I keep GEMINI.md or move to AGENTS.md?

Keep shared rules in AGENTS.md, since every major coding agent reads it, and leave GEMINI.md for anything only Gemini needs, or import AGENTS.md from it.

Your team’s rules, in every agent, checked on every PR.

Harbor is shared memory for your team’s Claude Code, Cursor, Codex and Copilot. Free for you and one teammate. No card. No end date.

Start free →

Product

  • How it learns
  • Only what fits
  • Pull request review
  • Keep it true
  • Handoffs
  • The result
  • Security
  • For coding agents
  • Pricing

Developers

  • Docs
  • Quickstart
  • Install
  • CLI
  • MCP server
  • Served and cited
  • Rule-file checker
  • Blog

Guides

  • Why Claude ignores CLAUDE.md
  • AGENTS.md vs CLAUDE.md
  • Share Claude Code memory with a team
  • Why Codex ignores AGENTS.md
  • Why Cursor ignores rules
  • Copilot instructions vs AGENTS.md
  • Shared memory across agents
  • Copilot Memory and Dreaming

Compare

  • All comparisons
  • vs Mem0
  • vs Zep
  • vs Unblocked
  • vs ByteRover
  • vs Cognee
  • vs Hindsight
  • vs OpenViking
  • vs Supermemory
  • vs Glen
  • vs MemPalace
  • vs Sentra
  • vs Trail-code

Company

  • Questions
  • Contact
  • X
  • LinkedIn
  • Privacy Policy
  • Terms of Service
  • Data Processing Agreement
  • Refund Policy
© 2026 HarborConnect your agents