agentleFS

AGENTS.md examples from real projects

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

Best matchesWorked for most · soon
steipeteAGENTS.md

oracle

steipete/oracle/docs/agents.md

Use Oracle from Claude Code, Codex, Cursor, and any other coding agent — as a CLI, as an MCP server, or as a one-shot skill.

Steady7 mentions in 2 weeks

No other project uses it yet

4.1k13d agoReviewMountCreate a free account to mount
reaatechAGENTS.md

mcp-gateway

reaatech/mcp-gateway/AGENTS.md

pnpm monorepo — API gateway for MCP server aggregation and routing

07mo agoReviewMountCreate a free account to mount
BlockAGENTS.md

model-ledger / guides

block/model-ledger/docs/guides/agents.md

The MCP server is the product. Eight tools and three resources let any agent explore, register, and reason about your model inventory.

144mo agoReviewMountCreate a free account to mount
mgovedarovAGENTS.md

mcp-vcf-orchestrator

mgovedarov/mcp-vcf-orchestrator/AGENTS.md

Practical operating instructions for AI agents working on the VCF Automation Orchestrator MCP server

531d agoReviewMountCreate a free account to mount
doomsday-networkAGENTS.md

web3-agent-skills

doomsday-network/web3-agent-skills/AGENTS.md

Audit GitHub bounties for on-chain Proof-of-Escrow backing (BountyGuard), query the Doomsday Network Remote MCP server (https://doomsday.network/mcp), and mine verified DoomHash Proof-of-Work pool shares for DOOM (L1) and wDOOM on Base Mainnet (0x623c84A5E04bF715018203334b0eFE41696eBC3E).

98d agoReviewMountCreate a free account to mount
work-planeAGENTS.md

workplane-skills / workplane

work-plane/workplane-skills/workplane/AGENTS.md

Publish or review agent work on Workplane — the working plane between AI and humans at workplane.co. Use this skill whenever you've produced reviewable output (code changes, research, analysis, designs, reports) that should be visible to humans, OR when asked to review work someone else published. Triggers on "publish this to workplane", "post to workplane", "share this on workplane", "review this project", workplane.co URLs, or whenever completing a substantial body of work that warrants human review. Uses the Workplane MCP server to create artifacts, upload files, snapshot versions with tags, and manage sharing.

146mo agoReviewMountCreate a free account to mount
Yakoub-aiAGENTS.md

Tech-Skills / mcp

Yakoub-ai/Tech-Skills/skills/mcp/AGENTS.md

Expert in Model Context Protocol server management, tool integration, and context optimization

06mo agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

command`: `hermes mcp serve` → `hermes mcp-serve`). A feature with no in-home signal (MCP clients live outside Hermes) gets an `in_use` that is always False: hint only, never

257k30d agoReviewMountCreate a free account to mount
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

Always-follow guidelines (common + per-language) scripts/ — Cross-platform Node.js utilities mcp-configs/ — 14 MCP server configurations tests/ — Test suite ``` `commands/` remains in the repo for compatibility, but the long

Steady32 mentions in 2 weeks

No other project uses it yet

246k2mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

configuration and, when applicable, the parent agent. ## Tools Sources: built-in aliases, specific tools, MCP servers (` /*`), extension tools. **Special**: `[]` = no tools, omit = defaults. Body reference: `#tool: ` ### Tool Aliases | Alias | Purpose

194k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

shell, MCP) │ │ - Provides session persistence as events.jsonl files │ │ - Supports fleet mode and plan mode │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ MCP Server (In-Process) │ │ (vscode-node/contribution.ts, vscode-node/inProcHttpServer.ts) │ │ - Provides VS Code-specific tools

194k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

inventory, not all contents of disabled installations and not proof that hooks executed or MCP servers connected. ### Copilot Connector authentication Copilot Connectors use the SDK session's GitHub credentials, including

194k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

openBrowserPage`, `runTask`, `getTaskOutput`) — NOT the extension's snake_case ids, and NOT shell / server-SDK / MCP tools (MCP is discovered dynamically and isn't in the launch snapshot). A line

194k3d agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / mcp

JuliusBrussee/caveman/mcp/AGENTS.md

mcp — the Caveman MCP server (Go core + launcher, Apache-2.0) A thin **stdio JSON-RPC** adapter exposing the compression [engine](../engine/CLAUDE.md) as five MCP tools to any host (Claude Code

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / mem

JuliusBrussee/caveman/mem/AGENTS.md

bm25.go` — deterministic tokenizer + BM25 scorer (non-negative scores, so the threshold is meaningful). - `cmd/cavemem/` — MCP server + `remember`/`recall`/`supersede`/`history`/`forget` CLI subcommands (JSON). - `js/` + `py/` — thin TS and Python

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / proxy

JuliusBrussee/caveman/proxy/AGENTS.md

accepted through the raw retry, and a compressed PAYG conversation without MCP recovery that streams (the server-side retrieve tool cannot ride a stream, so the conversation stays raw from

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright

microsoft/playwright/AGENTS.md

fixtures | Test runner: reporters, config, annotations, retries | | `tests/mcp/` | `import { test, expect } from './fixtures'` | `client`, `server` | MCP tools via `client.callTool()` | **Decision rule**: Does the test need `browser`/`browserType`/`context` → `tests/library/`. Just

99k3d agoReviewMountCreate a free account to mount
nexu-ioAGENTS.md

open-design / plugins

nexu-io/open-design/plugins/AGENTS.md

plugin content. A plugin may reference OD atoms, design systems, craft docs, assets, scripts, MCP servers, or connectors through the manifest. ## Authoring Rules - New spec examples belong under `plugins/spec/examples

Steady17 mentions in 2 weeks

No other project uses it yet

96k5mo agoReviewMountCreate a free account to mount
Model Context ProtocolAGENTS.md

servers / everything

modelcontextprotocol/servers/src/everything/AGENTS.md

changes and rebuilds automatically - Run STDIO server: `npm run start:stdio` - Starts the MCP server using stdio transport - Run SSE server: `npm run start:sse` - Starts the MCP server with

No other project uses it yet

92k8d agoReviewMountCreate a free account to mount
koala73AGENTS.md

worldmonitor

koala73/worldmonitor/AGENTS.md

Focused behavior check, `npm run typecheck`, `npm run lint:boundaries` | | API and handlers | `api/`, `server/`; [endpoint guide](docs/adding-endpoints.mdx) | Focused handler check, `npm run typecheck:api`; `npm run test:sidecar` owns

Steady26 mentions in 2 weeks

No other project uses it yet

89k8d agoReviewMountCreate a free account to mount
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.