Skip to main content
AGENTS.md is supported by over 20 AI coding agents and tools. The format is intentionally plain Markdown — no schema, no required fields, no tooling to install. Any agent that reads files in your repository can benefit from it immediately.

Compatible agents

Codex

OpenAI’s CLI coding agent. Native AGENTS.md support.

Amp

AI coding agent by Sourcegraph.

Jules

Google’s async coding agent.

Cursor

AI-powered code editor.

Factory

Automated software delivery platform.

RooCode

AI coding assistant.

Aider

Open-source terminal-based coding assistant.

Gemini CLI

Google’s CLI coding agent.

goose

Open-source AI agent by Block.

Kilo Code

AI coding assistant.

opencode

Open-source CLI coding agent.

Phoenix

AI coding agent.

Zed

High-performance code editor with AI rules support.

Semgrep

Static analysis tool with agent capabilities.

Warp

AI-powered terminal.

GitHub Copilot

GitHub’s AI coding agent.

VS Code

Microsoft’s code editor with AI features.

Ona

AI coding agent.

Devin

Autonomous coding agent by Cognition.

Windsurf

AI-powered code editor.

UiPath Autopilot & Coded Agents

UiPath’s Autopilot and Coded Agents platform.

Augment Code

AI coding assistant CLI.

Junie

JetBrains AI coding agent.

How agents use AGENTS.md

Precedence

In a monorepo with multiple AGENTS.md files at different directory levels, the closest file to the code being edited takes precedence. A file in packages/api/AGENTS.md overrides the root AGENTS.md for code inside that package. User chat prompts override everything.

Automatic test execution

Agents will attempt to execute testing commands found in AGENTS.md automatically. If you list pnpm test as your test command, the agent runs it to verify changes before finishing.
Keep your test command section accurate. Agents rely on it to validate their own work — a wrong command means broken changes slip through undetected.

Agent-specific guides

Some agents require explicit configuration or have particular conventions for using AGENTS.md.

Codex

OpenAI’s native AGENTS.md support.

Cursor

Using AGENTS.md in the Cursor editor.

Aider

Configure Aider to read AGENTS.md.

Gemini CLI

Configure Gemini CLI to read AGENTS.md.

GitHub Copilot

GitHub Copilot coding agent support.

Other agents

All other compatible agents.

Build docs developers (and LLMs) love