How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
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.
NousResearchAGENTS.mdNousResearch/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
affaan-mAGENTS.mdaffaan-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
Steady13 mentions in 2 weeks
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/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
Steady+17 stars this week
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/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
Steady+17 stars this week
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/vscode/src/vs/platform/agentHost/AGENTS.md
call-site compatibility; new provider code should import directly from `agent.ts`. ### Customization installation (Skills, MCP servers, catalog plugins) Installation is local-only: the workbench calls `IAgentHostService`, which routes through Management
No other project uses it yet
MicrosoftAGENTS.mdmicrosoft/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
Steady+17 stars this week
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/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
Steady16 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/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
Steady16 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/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
Steady16 mentions in 2 weeks
No other project uses it yet
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
