AGENTS.md examples from real projects

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

Best matches · from page 17Worked for most · soon

usewhaleAGENTS.md

Whale

usewhale/Whale/docs/agents.md

9254mo agoDiscuss

bgauryyAGENTS.md

octocode

bgauryy/octocode/AGENTS.md

detection, LSP pool. | [ARCHITECTURE](packages/octocode-engine/ARCHITECTURE.md) · [LSP lifecycle](packages/octocode-engine/docs/LSP_SERVER_LIFECYCLE.md) | | [`packages/octocode-mcp`](packages/octocode-mcp) | `octocode-mcp` | Thin MCP stdio server: lifecycle → security → tool registration → sanitized output. No business logic. | [ARCHITECTURE](packages/octocode-mcp/ARCHITECTURE.md) · [docs/OCTOCODE_MCP.md](docs/OCTOCODE_MCP.md) | | [`packages/octocode

92137d agoReads credentialsDiscuss

Model Context ProtocolAGENTS.md

ruby-sdk

modelcontextprotocol/ruby-sdk/AGENTS.md

concern end users - Check upstream remote for PRs if available ## Architecture overview ### Core Components **MCP::Server** (`lib/mcp/server.rb`): - Main server class handling JSON-RPC requests and holding shared configuration (tools, prompts

91933d agoDiscuss

retentioneeringAGENTS.md

retentioneering-tools

retentioneering/retentioneering-tools/AGENTS.md

Python widget traitlets and JS `model.get/set` keys are one protocol: rename them together. ### MCP server (ADR-0009) `mcp/server.py` is transport wiring only (FastMCP/SSE, `retentioneering.mcp.serve()`) — the report-building logic lives

91943d agoDiscuss

luckyPipewrenchAGENTS.md

pipelock

luckyPipewrench/pipelock/AGENTS.md

checks, not the literal-IP core SSRF floor. ### MCP Proxy `pipelock mcp proxy` wraps MCP servers with bidirectional scanning. Runtime modes in `internal/cli/runtime/mcp.go` are: - Subprocess stdio: `pipelock mcp proxy -- COMMAND

9126d agoDiscuss

awdr74100AGENTS.md

figwright

awdr74100/figwright/AGENTS.md

source, **bidirectional** Figma agent for MCP clients (Claude Code and others). It connects an MCP server to a Figma plugin over a local WebSocket relay, letting an AI agent both

9114mo agoDeletes or force-pushesDiscuss

AWSAGENTS.md

agent-plugins

awslabs/agent-plugins/AGENTS.md

apply to both automatically. ## TL;DR Pitch This repository supports **plugins** - bundles of skills, MCP servers, and agent configurations that extend capabilities. The `awslabs/agent-plugins` marketplace includes plugins like `deploy

8997mo agoDiscuss

vostrideAGENTS.md

agent-qa

vostride/agent-qa/AGENTS.md

pnpm --filter @vostride/agent-qa-core test`. - For dashboard server changes, run `pnpm --filter @vostride/agent-qa-dashboard test`. - For dashboard UI changes, run `pnpm --filter @vostride/agent-qa-dashboard-ui test`. - For MCP changes, run `pnpm --filter @vostride/agent-qa-mcp test

8994mo agoReads credentialsDiscuss

ChiR24AGENTS.md

Unreal_mcp

ChiR24/Unreal_mcp/AGENTS.md

plugin version `0.6.0-beta-b` (separate `.uplugin`). Two user-facing surfaces: a TypeScript stdio MCP server, and the bridge plugin's WebSocket transport and optional native `/mcp` HTTP/SSE transport. Area

8914mo agoReads credentialsDiscuss

ChiR24AGENTS.md

Unreal_mcp / tests

ChiR24/Unreal_mcp/tests/AGENTS.md

TEST KNOWLEDGE BASE Test infrastructure for the TypeScript MCP server and Unreal bridge contracts. Vitest tests run without Unreal; MCP integration suites normally require a built server plus a connected

8914mo agoDiscuss

CloudflareAGENTS.md

mcp

cloudflare/mcp/AGENTS.md

AGENTS.md ## Project overview `cloudflare-mcp` is a token-efficient Model Context Protocol (MCP) server that exposes the entire Cloudflare API (~2,500 endpoints) using Cloudflare's **Code Mode** pattern. Instead

8917d agoDiscuss

ornerydAGENTS.md

NornicDB

orneryd/NornicDB/AGENTS.md

type:** - **Core logic** (cypher, storage): 95%+ coverage - **Utilities** (cache, pool): 90%+ coverage - **Integration** (bolt, server): 85%+ coverage - **UI/CLI**: 70%+ coverage (focus on business logic) **What to test:** ✅ **Always test:** - Happy

8877mo agoDiscuss

Microsoft AzureAGENTS.md

azure-sdk-for-rust

Azure/azure-sdk-for-rust/AGENTS.md

AGENTS.md This document provides guidance for AI agents (e.g., GitHub Copilot, MCP servers, or LLM-based assistants) interacting with the Azure SDK for Rust repository. ## Repository Overview The Azure

88613d agoDiscuss

hyper-mcp-rsAGENTS.md

hyper-mcp

hyper-mcp-rs/hyper-mcp/AGENTS.md

AGENTS.md ## Project Overview hyper-mcp is a Rust-based Model Context Protocol server that loads and manages plugins (WASM binaries) at runtime. ## Tooling - **defuddle** — Fetches web pages and converts them

8813mo agoDiscuss

MicrosoftAGENTS.md

AL / al-issue-triager

microsoft/AL/.github/agents/al-issue-triager/AGENTS.md

skill owns ALTool's internal symbol-download protocol; do not launch or script an MCP server yourself; - never invoke `alc.exe` directly, hand-script an MCP server, or call `/dev/packages` manually

88142d agoDiscuss

SentryAGENTS.md

sentry-mcp

getsentry/sentry-mcp/AGENTS.md

tools/ # 19 tool modules │ │ ├── server.ts # buildServer() │ │ ├── api-client/ # Sentry API │ │ └── internal/ # Shared utils │ ├── mcp-server/ # stdio transport (@sentry/mcp-server on npm) │ ├── mcp-cloudflare/ # Web app + OAuth │ ├── mcp-server-evals/ # AI evaluation

8677mo agoDiscuss

mereyabdenbekuly-ctrlAGENTS.md

clodex-ide

mereyabdenbekuly-ctrl/clodex-ide/AGENTS.md

never trusted to the public IDE. - Paid-only capabilities must be implemented and authorized server-side in a separately secured private managed service. The public client may contain only reviewed

8643mo agoDiscuss

wecode-aiAGENTS.md

Wegent

wecode-ai/Wegent/AGENTS.md

direction rather than choosing an owner by guesswork. ## Domain model ``` Ghost (prompt, MCP servers, skills) -> Bot (Ghost + Shell + optional Model) -> Team (Bots + collaboration mode) -> Task (Team + Workspace) ``` Code uses

86340d agoDiscuss

AgriciDanielAGENTS.md

compass

AgriciDaniel/compass/AGENTS.md

guide it points to. Setup state: `00 Dashboards/Setup.md`. - Knowledge layer routing: `wiki/routing-map.md`. ## Driving Obsidian (MCP server `obsidian`) Prefer these tools over raw file access when they are available; they

85736d agoDiscuss

kdlbsAGENTS.md

kandev

kdlbs/kandev/AGENTS.md

released_total`. Release reasons are the closed set `stop`, `editor_idle`, `detached_timeout`, `capacity`, `server_exit`, `runtime_stop`, and `backend_stop`; lease, task, session, execution, user, and language identifiers

85321d 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.