Frequently Asked Question

What is AGENTS.md?

AGENTS.md is an emerging cross-vendor convention for giving a coding agent persistent, project-specific instructions: build commands, coding standards, architectural decisions, and the location of things. It plays the same role for Codex that CLAUDE.md plays for Claude Code.

The advantage of the vendor-neutral name is that one file can serve several tools. Claude Code reads CLAUDE.md rather than AGENTS.md, but you can bridge the gap with a one-line CLAUDE.md that imports the other file with @AGENTS.md, or with a symlink. Gemini CLI can be pointed at AGENTS.md directly by setting context.fileName in its settings.

If you work with more than one agent, consolidating on a single file saves maintaining three that say the same thing and then drift apart.