AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

ruvnet 10k+ stars

ruvnetReads credentialsAGENTS.md

RuView

ruvnet/RuView/AGENTS.md

This file is the root Codex contract for ruvnet/RuView. It complements CLAUDE.md; scoped AGENTS.md files may add local rules but must not weaken the security, evidence, or release requirements here. RuView is a camera-free RF perception system. Production Rust lives in v2/, the Python reference pipeline in archive/v1/, ESP32 firmware in firmware/, the portable contributor harness in harness/ruview/, and the focused Homecore metaharness in harness/homecore/. - Preserve unrelated changes in a dirty worktree. Use an isolated branch/worktree for broad work;…

1 project uses a version of this

102k8mo agoReviewMount

ruvnetAGENTS.md

RuView / monitoring

ruvnet/RuView/.claude/commands/monitoring/agents.md

Tool: mcpclaude-flowagent_list In Claude Code: 1. List all agents: Use tool mcpclaude-flowagentlist 2. Get specific agent metrics: Use tool mcpclaude-flowagentmetrics with parameters {"agentId": "coder-123"} 3. Monitor agent performance: Use tool mcpclaude-flowswarm_monitor with parameters {"interval": 2000}

28 projects use a version of this

102k8mo agoReviewMount

ruvnetReads credentialsAGENTS.md

ruflo

ruvnet/ruflo/AGENTS.md

For OpenAI Codex CLI - Agentic AI Foundation standard Skills: $skill-name | Config: .agents/config.toml Workflow (Use MCP Tools): 1. memorysearch(query="task keywords") → LEARN from past patterns (score > 0.7 = use it) 2. swarminit(topology="hierarchical") → coordination record (instant) 3. YOU write the code / run the commands ← THIS IS WHERE WORK HAPPENS 4. memory_store(key="pattern-x", value="what worked", namespace="patterns") → REMEMBER for next time Ruflo is the coordination ledger and policy decision point. Codex agents are the executors. Coordination records do…

Surging55 mentions in 2 weeks

3 projects use a version of this

79k11d agoReviewMount

CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.