AGENTS.md examples from real projects

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.

No other project uses it yet

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

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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

MicrosoftAGENTS.md

vscode / agentHost

microsoft/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.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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

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

No other project uses it yet

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

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

No other project uses it yet

koala73AGENTS.md

worldmonitor

koala73/worldmonitor/public/agents.md

Machine interfaces, authentication, request policy, and rate limits.

No other project uses it yet

bytedanceAGENTS.md

deer-flow / backend

bytedance/deer-flow/backend/AGENTS.md

correlates `ToolMessage`, `task_*` SSE/persisted events, frontend cards and `ExtensionData.scope_id` (`SubagentResult.external_task_id`). Unique server `execution_id` owns `SubagentResult.task_id`, registry, polling, cancellation, timeout and cleanup. Provider IDs can collide

No other project uses it yet

jesseduffieldAGENTS.md

lazygit

jesseduffield/lazygit/AGENTS.md

files, and anything textual. Don't adopt the full workflow from `gopls mcp -instructions` (vulncheck on session start, `go_file_context` after every file read); that overhead isn't worth

No other project uses it yet

storytoldAGENTS.md

photocraft

storytold/photocraft/AGENTS.md

command) ui-egui automation L6 egui shell (thin: all actions go through the engine); MCP server testkit test helpers apps/ photocraft desktop app (eframe/wgpu), TCP control server photocraft-cli headless

No other project uses it yet

code-yeongyuAGENTS.md

oh-my-opencode / packages

code-yeongyu/oh-my-opencode/packages/AGENTS.md

stdio-core/AGENTS.md) | `src/`, `tsconfig.json` | Shared JSON-RPC stdio framing and dispatch primitives for MCP servers. | | [`tmux-core/`](tmux-core/AGENTS.md) | `src/`, `tsconfig.json` | Harness-neutral tmux session, pane, layout

openinterpreterAGENTS.md

open-interpreter

openinterpreter/open-interpreter/AGENTS.md

elsewhere. The exception is app-server API documentation, which is covered by the app-server guidance below. - Prefer private modules and explicitly exported public crate API. - If you change `ConfigToml