Claude Code mod
agents-md
AGENTS.md as project instructions, by one option. Under claude-md-or-agents-md a project with no instruction files of its own gets its AGENTS.md files instead: a prompt.context hook asks $.fs.ancestors for every AGENTS.md and .claude/AGENTS.md from the filesystem root down to the working directory and hands them to the engine as project instruction files, which it renders, announces and withholds from agents exactly as it does CLAUDE.md, skipping any file the engine already loaded by import or link; a tool.call hook on Read attaches the ones under the project root as the engine attaches a nested CLAUDE.md. Under claude-md-and-agents-md every AGENTS.md is loaded beside CLAUDE.md. Under managed-only the project's and the person's instruction files are dropped and the organization's managed ones kept. Under claude-md the engine's walk stands alone. claude-md-or-agents-md is the default.
Install
/pluginThis mod ships with Claude Code. Turn it on or off from /plugin.
What it can access
- Reach
- L1Reads: reads files, reads env vars, telemetry, draws
- Sees
- the system prompt, subagent spawns, Read calls
- Hooks
session.startprompt.contextagent.spawntool.call
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- anthropics/claude-code
- Folder
mods/agents-md- Author
- Anthropic
- Last updated
- 31 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is agents-md?
AGENTS.md as project instructions, by one option. Under claude-md-or-agents-md a project with no instruction files of its own gets its AGENTS.md files instead: a prompt.context hook asks $.fs.ancestors for every AGENTS.md and .claude/AGENTS.md from the filesystem root down to the working directory and hands them to the engine as project instruction files, which it renders, announces and withholds from agents exactly as it does CLAUDE.md, skipping any file the engine already loaded by import or link; a tool.call hook on Read attaches the ones under the project root as the engine attaches a nested CLAUDE.md. Under claude-md-and-agents-md every AGENTS.md is loaded beside CLAUDE.md. Under managed-only the project's and the person's instruction files are dropped and the organization's managed ones kept. Under claude-md the engine's walk stands alone. claude-md-or-agents-md is the default. It is a mod for Claude Code, from anthropics/claude-code on GitHub.
What can the agents-md mod access?
Its widest reach is "reads" (reads files, reads env vars, telemetry, draws). It sees the system prompt, subagent spawns, Read calls. Like any mod, it runs with your permissions.
How do I install agents-md?
Clone anthropics/claude-code and start Claude Code with --plugin-dir pointing at the mod's folder (mods/agents-md).
Is agents-md popular?
anthropics/claude-code has 154,122 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 31 October 2026.
More memory & instructions mods
code-modernization
46kanthropics/claude-plugins-official
Guided modernization for any legacy codebase: start with /modernize, get an assessment, an interactive map, the business rules mined from the code, and a plan you approve, then an upgrade, a rewrite or a rebuild with independent proof that the new code behaves like the old. Includes security hardening, a one-page report, specialist agents, and an optional live progress pane (early access).
storybloq
787Storybloq/storybloq
Project memory for Claude Code and Codex. Storybloq stores tickets, issues, handovers, and lessons in a .story/ folder inside your repo.
ruflo-agentdb
80kruvnet/ruflo
Substrate plugin for Ruflo memory: AgentDB controller bridge (15 agentdb_* MCP tools), RuVector ONNX embeddings (10 embeddings_* tools incl. RaBitQ 32x quantization), and WASM HNSW pattern router (3 ruvllm_hnsw_* tools). As a mod (ADR-445): opt-in safe recall into the prompt, a write guard that keeps secrets out of memory, /agentdb, and a status file the console shows
memory-lens
300yonatangross/orchestkit
Recalls the few memories related to each prompt you send (never on automated turns or file tool calls): one line for the human, one context entry for the model. Local files only, no network on the hot path.
operator
487aerovato/operator-memory
Durable project and user memory for agent-driven development in Claude Code.
ctx-handoff
125cablate/ctx-handoff-mod
Turns what you teach Claude into project notes, catches its usual slips, keeps the cache warm while you're away, and picks long sessions back up
Browse the most popular Claude Code mods, all memory & instructions mods, or the skills and MCP server directories.