Cc Agents Md banner
GeiserX GeiserX

Cc Agents Md

Development community

Description

Load AGENTS.md into Claude Code sessions — no CLAUDE.md needed

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

cc-agents-md banner

CI npm version License: GPL-3.0 Codecov

Claude Code only reads `CLAUDE.md`. The [AGENTS.md specification](https://agents.md) is supported by 23+ tools (Codex, Cursor, Copilot, Gemini CLI, and more), but Claude Code is not one of them. This has been the [most requested feature](https://github.com/anthropics/claude-code/issues/6235) (3,600+ upvotes) with no official response.

**cc-agents-md** fixes this. One command, and every Claude Code session automatically loads your AGENTS.md files. No CLAUDE.md wrapper files. No symlinks.

How It Works

Three hooks are registered in `~/.claude/settings.json`:

  1. SessionStart — On every new Claude Code session, walks upward from your working directory to the git root, collects every AGENTS.md on the path, and injects the content
  2. UserPromptSubmit — On each user message, checks if AGENTS.md files changed since last injection. If changed, re-injects updated content. If unchanged, exits silently (zero overhead)
  3. PreCompact — Before context compression, re-injects AGENTS.md content so instructions survive in long sessions

Small files are **inlined** directly into Claude's context. Large files get a **read instruction** — Claude reads the full file on demand.

monorepo/
├── AGENTS.md                  ← always loaded (project root)
├──