What Are the Details for Each Agent?
Claude Code
Reads CLAUDE.md from the working directory and the directories above it, plus CLAUDE.local.md and your user file in ~/.claude/. CLAUDE.md can import other files with @path, up to four hops deep. From v2.1.277 it can read AGENTS.md, but by default only when there is no CLAUDE.md or CLAUDE.local.md in the working directory or above it; the Project instructions setting (claude-md-and-agents-md) loads both. A CLAUDE.md containing @AGENTS.md works on every version.
Source: code.claude.com/docs/en/memory, checked 2026-11-13.
OpenAI Codex
Reads AGENTS.md (or AGENTS.override.md, which wins in the same directory) from ~/.codex, then from the project root down to the working directory, concatenating them so the closest file comes last. Extra file names can be added as fallbacks. It stops adding files once the combined size reaches project_doc_max_bytes, 32 KiB by default.
Source: developers.openai.com/codex/guides/agents-md, checked 2026-11-13.
GitHub Copilot
Every Copilot surface that supports custom instructions reads .github/copilot-instructions.md. Agent files (AGENTS.md, CLAUDE.md, GEMINI.md) are read by the Copilot cloud agent, Copilot code review on github.com (which also reads REVIEW.md) and the Copilot CLI. Copilot Chat in VS Code reads AGENTS.md. Copilot Chat on github.com, in Visual Studio, JetBrains, Eclipse and Xcode does not read agent files, which is why the Copilot file should carry the essentials itself.
Source: docs.github.com/en/copilot/reference/custom-instructions-support, checked 2026-11-13.
Cursor
Project rules are .mdc files in .cursor/rules with description, globs and alwaysApply frontmatter; plain .md files in that folder are ignored. AGENTS.md is supported in the project root and in subdirectories, where nested files combine with their parents and the more specific one wins. The single .cursorrules file is documented as legacy.
Source: cursor.com/docs/rules, checked 2026-11-13.
Gemini CLI
Reads GEMINI.md from ~/.gemini and from the project directories, and GEMINI.md can import other files with @file.md. The file name is configurable: set context.fileName in settings.json to a list such as ["AGENTS.md", "GEMINI.md"] to have it read AGENTS.md as well.
Source: geminicli.com/docs/cli/gemini-md/, checked 2026-11-13.
Windsurf
AGENTS.md, AGENTS.local.md and AGENT.md are always-on rules, read at the workspace root and in each directory down to the one being worked on. Finer rules go one per file in .devin/rules/*.md with trigger frontmatter (always_on, model_decision, glob, manual). The legacy .windsurf/rules/*.md, .windsurf/global_rules.md and .windsurfrules files are still imported.
Source: docs.windsurf.com/windsurf/cascade/agents-md, checked 2026-11-13.
Zed
Uses only the first file it finds, in this order: .rules, .cursorrules, .windsurfrules, .clinerules, .github/copilot-instructions.md, AGENT.md, AGENTS.md, CLAUDE.md, GEMINI.md. A leftover .cursorrules therefore hides your AGENTS.md from Zed. A personal ~/.config/zed/AGENTS.md also applies; project files win on conflict.
Source: zed.dev/docs/ai/instructions, checked 2026-11-13.
Cline
Reads rule files in .clinerules/ or .cline/rules/, AGENTS.md, and a cross-tool global ~/.agents/AGENTS.md. It also detects .cursorrules and .windsurfrules.
Source: docs.cline.bot/customization/cline-rules, checked 2026-11-13.
Jules
Listed as AGENTS.md-compatible on agents.md. The Jules documentation site did not render without JavaScript when we checked, so we have not read its own wording; confirm on jules.google before relying on details.
Source: agents.md/, checked 2026-11-13.
Aider
Reads no instruction file automatically. You load one with /read CONVENTIONS.md, aider --read, or a read: entry in .aider.conf.yml. Pointing that at AGENTS.md works the same way.
Source: aider.chat/docs/usage/conventions.html, checked 2026-11-13.