---
title: "AGENTS.md"
description: "AGENTS.md is an open format for guiding coding agents: a markdown file, usually at a repository's root, that holds the instructions an agent needs to work in that project."
canonical: "https://agentdrive.sh/glossary/agents-md"
---
# AGENTS.md

> For the complete documentation index, see [llms.txt](https://agentdrive.sh/llms.txt). Every docs page is also served as markdown at its URL plus `.md`, and the full docs are in one file at [llms-full.txt](https://agentdrive.sh/llms-full.txt).

> AGENTS.md is an open format for guiding coding agents: a markdown file, usually at a repository's root, that holds the instructions an agent needs to work in that project.

Source: https://agentdrive.sh/glossary/agents-md. Part of the AgentDrive glossary: https://agentdrive.sh/glossary.

It carries the extra context that would clutter a README or that human contributors do not need, such as build steps, test commands and code style. Large monorepos can place nested AGENTS.md files inside subprojects, and agents follow the closest one. Codex, Cursor and OpenCode read it, and Claude Code can read it in place of CLAUDE.md. The format is stewarded by the Agentic AI Foundation under the Linux Foundation.

## In AgentDrive

AGENTS.md holds the rules you write for every session; AgentDrive keeps what each session actually did, so the two work side by side. With auto-context on, `adrive init` adds a short marked block to the user-level AGENTS.md of Codex and OpenCode telling the agent when to call the AgentDrive MCP tools, and turning auto-context off removes it. It never edits a repository's AGENTS.md.

## Related terms

- [CLAUDE.md](https://agentdrive.sh/glossary/claude-md/index.md): CLAUDE.md is a markdown file of instructions that Claude Code reads at the start of every session, giving it persistent context for a project, your personal workflow or an organization.
- [Coding agent](https://agentdrive.sh/glossary/coding-agent/index.md): A coding agent is an AI tool that works through a software task in a code repository: it reads and edits files, runs commands such as tests, and reports back.
- [Handoff brief](https://agentdrive.sh/glossary/handoff-brief/index.md): A handoff brief is the summary of a coding-agent session that AgentDrive gives the next agent: the goal, the files touched and the most recent turns, sized to a character budget.

## Go deeper

- [AgentDrive vs CLAUDE.md and handoff notes](https://agentdrive.sh/compare/claude-md-handoff-notes)
- [Sessions: auto-context and privacy controls](https://agentdrive.sh/docs/concepts/sessions)

## Official source

- [agents.md](https://agents.md/)

