AGENTS.md examples from real projects

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

Best matches · from page 10Worked for most · soon

crmneAGENTS.md

ruby_llm

crmne/ruby_llm/AGENTS.md

4.4k17d agoReads credentialsDiscuss

archestra-aiAGENTS.md

archestra / platform

archestra-ai/archestra/platform/AGENTS.md

clicking your name in the sidebar) - **MCP Registry**: <http://localhost:3000/mcp/registry> (Install and manage MCP servers) - **LLM Proxy Logs**: <http://localhost:3000/llm/logs> (View LLM proxy request logs) - **MCP Gateway Logs

4.3k4d agoReads credentialsDiscuss

dagucloudAGENTS.md

dagu

dagucloud/dagu/AGENTS.md

Workflows are YAML DAGs. The root Go module builds one binary containing the CLI, server, scheduler, coordinator, and worker. Runtime state is file-backed; no control-plane database or broker

4.2k5mo agoDiscuss

kirodotdevAGENTS.md

KiroCrew

kirodotdev/KiroCrew/AGENTS.md

skills-hooks](docs/system-specs/modules/memory-skills-hooks.md) | | `context.py`, `context_blocks.py`, what reaches the model's context | [context-management](docs/architecture/context-management.md) | | MCP servers or tools (adding, changing, statelessness) | [mcp](docs/architecture/mcp.md) | | apps, App Kit, manifests, app agents

4.2k32d agoReads credentialsDiscuss

melgarafaelAGENTS.md

DeskcommCRM

melgarafael/DeskcommCRM/AGENTS.md

clínicas, imobiliárias, infoprodutos, serviços), WhatsApp como canal primário via WAHA, CRM inteiro exposto por MCP. Multi-tenant com RLS desde o dia 1; LGPD nativa. Monetização = **self-host

4.2k13d agoReads credentialsDiscuss

nyldnAGENTS.md

claude-octopus

nyldn/claude-octopus/AGENTS.md

Alias | |-----------------|---------------| | Read | read | | Write, Edit | edit | | Bash | execute | | Grep, Glob | search | ## MCP Integration The MCP server (`mcp-server/`) exposes Claude Octopus workflows as MCP tools. For MCP-aware coding agents

4.1k49d agoReads credentialsDiscuss

basicmachines-coAGENTS.md

basic-memory

basicmachines-co/basic-memory/AGENTS.md

Import functionality for Claude, ChatGPT, and other sources - `/markdown` - Markdown parsing and processing - `/mcp` - MCP server + `container.py` composition root + `clients/` typed API clients - `/models` - SQLAlchemy ORM models - `/picoschema` - Picoschema parsing

4.1k2mo agoReads credentialsDiscuss

bethingtonAGENTS.md

ghidra-mcp

bethington/ghidra-mcp/AGENTS.md

documentation workflows ## Directory Structure - `src/` — Java source for Ghidra extension and headless server - `python/bridge_mcp_ghidra/` — Python MCP bridge package (`bridge-mcp-ghidra` console script / `python -m bridge_mcp_ghidra`) - `pyproject.toml` + `uv.lock

4k7d agoDiscuss

Gaurav-GosainAGENTS.md

tuios

Gaurav-Gosain/tuios/AGENTS.md

detection │ ├── integration/ # Wires harness hooks, plugins and MCP entries (tuios integration) │ ├── mcp/ # The MCP server behind tuios mcp │ ├── risk/ # Marks an approval risky by the shipped and configured rules │ ├── agentproto

4k8d agoDiscuss

Hugging FaceAGENTS.md

huggingface_hub

huggingface/huggingface_hub/AGENTS.md

CRUD and scaling. - `_jobs_api.py` — Training jobs API. - `_space_api.py` — Space runtime/hardware/storage types. - `_webhooks_server.py` / `_webhooks_payload.py` — Webhook server and payload definitions. - `constants.py` — All environment-variable-driven constants (timeouts, cache paths, endpoints). - `errors.py` — Custom

3.9k6mo agoDiscuss

evalstateAGENTS.md

fast-agent

evalstate/fast-agent/AGENTS.md

src/fast_agent/acp/`, and `src/fast_agent/a2a/` are protocol adapters around the harness and agent runtime. MCP primarily supplies tools/resources/prompts and server transports; ACP exposes fast-agent sessions to editor clients; A2A exposes

3.9k8d agoDiscuss

nowork-studioAGENTS.md

notfair-plugin

nowork-studio/notfair-plugin/AGENTS.md

NotFair to the latest version | `upgrade` | `notfair-upgrade-skill/SKILL.md` | ## External dependencies - **Universal NotFair MCP** — `https://notfair.co/api/mcp/notfair`, OAuth. The plugin registers this single connection for Google Ads, Meta

3.9k25d agoReads credentialsDiscuss

OpenAIAGENTS.md

openai-agents-js

openai/openai-agents-js/AGENTS.md

keys and other long-lived secrets out of browser bundles and client examples. Use server-side credentials and the supported short-lived client credential flow when a browser integration needs

3.9k8mo agoReads credentialsDiscuss

AtmosphereAGENTS.md

atmosphere

Atmosphere/atmosphere/AGENTS.md

feature area. - E2E tests MUST assert the specific feature under test, not just "server started". - Tests must assert the specific behavior they claim to verify — `expect(true).toBe(true

3.8k6d agoDiscuss

MicrosoftAGENTS.md

mcp

microsoft/mcp/AGENTS.md

Azure, Microsoft Fabric, and other Microsoft services. This repository contains the core libraries, multiple MCP servers, service-specific tools, and comprehensive testing infrastructure for building agent-integrated Microsoft service interactions

3.7k29d agoReads credentialsDiscuss

xintaofeiAGENTS.md

codeg

xintaofei/codeg/AGENTS.md

features --bin codeg-server --lib cargo clippy --no-default-features --bin codeg-server --lib -- -D warnings # codeg-mcp 协作伴生进程（多智能体委托） cargo check --no-default-features --bin codeg-mcp cargo clippy

3.7k8d agoDiscuss

Model Context ProtocolAGENTS.md

java-sdk

modelcontextprotocol/java-sdk/AGENTS.md

Model Context Protocol](https://modelcontextprotocol.io), enabling Java applications to implement MCP clients and servers (sync and async) over stdio, SSE, and Streamable HTTP transports. ## Modules - `mcp-core` — protocol types, schema

3.7k3mo agoDiscuss

ObservalAGENTS.md

Observal

Observal/Observal/AGENTS.md

github MCP") Agents are the primary entity. Each agent bundles 5 component types: MCP servers, skills, hooks, prompts, and sandboxes. When a user runs `observal agent pull `, the platform resolves

3.7k2mo agoDiscuss

stickerdanielAGENTS.md

linkedin-mcp-server

stickerdaniel/linkedin-mcp-server/AGENTS.md

commit run --all-files` - Run server locally: `uv run -m linkedin_mcp_server --no-headless` - Run via uvx (PyPI/package verification only): `uvx mcp-server-linkedin` - Docker build: `docker build

3.6k24d agoDiscuss

AvdLeeAGENTS.md

SwiftUI-Agent-Skill

AvdLee/SwiftUI-Agent-Skill/AGENTS.md

SwiftUI-specific needs only) - General Swift language features unrelated to SwiftUI - Backend or server-side Swift patterns - UIKit patterns (except when bridging is necessary) ### 2. No Code Formatting or Linting

3.6k55d agoDiscuss

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.