Skip to content
Agent Friendly Code

Codex vs Gemini CLI: which do top repos set up for?

Codex averages higher: 70.5 for Codex and 63.5 for Gemini CLI, across 402 repos. Codex scores higher on 397, Gemini CLI on 5, and 0 tie.

Scores measure how well each repo is set up for an agent: instruction files, tests, CI and the other checks, weighted by what each agent's docs say it uses, not which agent writes better code.

Which files does each one read?

Reads from the repo
Codex: AGENTS.mdAGENTS.override.md.agents/skills/
Gemini CLI: GEMINI.md.agents/skills/
Reads AGENTS.md
Codex: Always
Gemini CLI: Only when configured to
Reads CLAUDE.md
Codex: No
Gemini CLI: No
From its docs
Codex: Reads AGENTS.md before any work, one per directory from the repo root down to the working directory, up to 32 KiB combined; AGENTS.override.md replaces the AGENTS.md beside it.
Gemini CLI: Reads GEMINI.md from the global file, the workspace and its parent directories, and one per subdirectory once a tool reaches it. AGENTS.md loads once listed in the context.fileName setting.
Repos with its own file
Codex: AGENTS.md: 207 of 402 (51%)
Gemini CLI: GEMINI.md: 6 of 402 (1%)

AGENTS.md and CLAUDE.md mean the file at the repo root; a repo with both counts under AGENTS.md, and empty files don't count. Every agent's files.

Which checks does each weigh more?

Share of each agent's score that a check carries, where Codex and Gemini CLI differ most
CheckCodexGemini CLI
GEMINI.md0%11%
AGENTS.md / CLAUDE.md11%8%
CI configuration9%7%
Reproducible dev env9%8%
Type configuration9%10%
Manageable size6%5%

Each figure is the check's share of the agent's total weight, from the docs linked below. A check few repos pass, such as an agent's own file, lowers that agent's scores wherever it carries weight. The methodology lists every weight.

Which repos are set up better for Codex than Gemini CLI?

Which repos are set up better for Gemini CLI than Codex?

Which one leads in each language?

Average Codex and Gemini CLI scores of the repos in each language; the higher is in bold
LanguageReposCodexGemini CLI
TypeScript8375.767.6
Python5674.166.9
Rust4574.067.5
Go4074.667.6
Java2865.558.8
C++2162.455.5
JavaScript1577.169.6

What if I use both?

  1. Write the shared instructions once, in AGENTS.md at the repo root. What to put in it.
  2. Codex: reads AGENTS.md before any work, up to 32 KiB combined across directories.
  3. Gemini CLI: list AGENTS.md in the context.fileName setting, or keep a GEMINI.md.

AGENTS.md vs CLAUDE.md · Which files each agent reads · Make a repo agent-ready

From the docs: learn.chatgpt.com/agents-md (new tab) · learn.chatgpt.com/build-skills (new tab) · geminicli.com/gemini-md (new tab) · geminicli.com/skills (new tab)

Boards: best set up for Codex · best set up for Gemini CLI

More comparisons: Claude Code vs Cursor · Claude Code vs Codex · Gemini CLI vs Claude Code · Cursor vs Codex · Aider vs Claude Code · OpenHands vs Claude Code · Pi vs Claude Code · Kimi Code CLI vs Claude Code · Devin vs Claude Code