AGENTS.md
Open Markdown format for giving coding agents project instructions
Introduction
AGENTS.md is an open Markdown format that works like a README for coding agents. It holds setup commands, test steps and code style rules, and nested files can cover subprojects in a monorepo. Many AI coding tools read it.
- Added on
- Nov 2, 2026
- Website
- agents.md
- Pricing model
- Free
- Company
- LF Projects, LLC
Product information
What is AGENTS.md?
AGENTS.md is an open Markdown format that gives coding agents project-specific instructions such as setup, testing and conventions, keeping READMEs focused on human contributors.
How to use AGENTS.md?
Create an AGENTS.md at the repository root for general guidance, or in subdirectories for specific projects. Add setup and test commands, code style rules and key context.
Core features of AGENTS.md
- Open Markdown format for agents
- Central place for setup, testing and style
- Nested files for monorepos
- Compatible with many coding agents
- Keeps READMEs human-focused
Use cases of AGENTS.md
- 1Documenting build and test commands for agents
- 2Sharing repository conventions
- 3Giving subprojects their own instructions
- 4Helping new agents learn a project workflow quickly
Frequently asked questions about AGENTS.md
Where should I put an AGENTS.md file?+
At the repository root for global instructions, or in subdirectories for more specific guidance.
Do coding agents use the nearest AGENTS.md file?+
Yes. The closest AGENTS.md in the directory tree takes precedence.
What should I include in AGENTS.md?+
Setup commands, test commands, code style conventions and project-specific context.
Which category is AGENTS.md in?+
AGENTS.md is listed under AI Code Assistant.