AGENTS.md Bridge

Make Claude Code read AGENTS.md — without committing a Claude-specific file to your repo.

AGENTS.md is the vendor-neutral standard for agent instructions, read natively by Codex, Cursor, Windsurf and others. Claude Code reads only CLAUDE.md (issue #6235, 4,000+ 👍, still open). The usual workarounds either break on Windows or push a CLAUDE.md into your repo. This plugin avoids both.

How it works

On every session start, a hook walks your project and, next to each AGENTS.md, writes a CLAUDE.md containing one line:

@AGENTS.md

That's a Claude Code import, so AGENTS.md stays the single source of truth — nothing is copied, nothing can drift. Generated files go into .git/info/exclude (a local ignore), so nothing Claude-branded is ever committed.

Guarantees

• ✓ Your hand-written CLAUDE.md is never touched.
• ✓ Cross-platform — pure file I/O, no symlinks (works on Windows).
• ✓ Nested AGENTS.md handled; node_modules and build dirs skipped.
• ✓ Self-healing — regenerated every session.
• ✓ Collects no data. No network, no telemetry. (Privacy)

Install

Inside a Claude Code session (these are interactive slash commands, not terminal commands):

/plugin marketplace add aetherforge-us/marketplace
/plugin install agents-md-bridge@aetherforge