claude-agentsmd

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:

1. finds all AGENTS.md files (excluding .git/)
2. cps each to a sibling CLAUDE.md
3. Ensures CLAUDE.md is in .gitignore
4. 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