claude-agentsmd
A Claude Code plugin that syncs AGENTS.md → CLAUDE.md recursively across your entire project tree.
What it does
- On session start and before every prompt, finds all
AGENTS.md files in your project
- Copies each to a sibling
CLAUDE.md in the same directory
- Injects the content directly into Claude's context (so it takes effect immediately, without requiring a restart)
- Adds
CLAUDE.md to .gitignore (if not already present)
Why
Some tools and workflows standardise on AGENTS.md for agent instructions. Claude Code reads CLAUDE.md. This plugin keeps them in sync transparently.
Install
/plugin marketplace add intellectronica/claude-agentsmd
/plugin install claude-agentsmd@intellectronica-claude-agentsmd
Then restart Claude Code.
How it works
Uses SessionStart and UserPromptSubmit hooks that run a shell script. The script:
finds all AGENTS.md files (excluding .git/)cps each to a sibling CLAUDE.md- Ensures
CLAUDE.md is in .gitignore
- Outputs the content to stdout wrapped in
<claudeMd> tags, which Claude Code injects directly into context
The hooks have a 10-second timeout.
Requirements
- Claude Code with plugin support
bash, find, cp, grep (standard on macOS and Linux)
Licence
CC0 1.0 Universal
intellectronica