{"id":48856783,"url":"https://github.com/geiserx/cc-agents-md","last_synced_at":"2026-04-15T13:02:05.517Z","repository":{"id":351524375,"uuid":"1211360259","full_name":"GeiserX/cc-agents-md","owner":"GeiserX","description":"Load AGENTS.md into Claude Code sessions — no CLAUDE.md needed","archived":false,"fork":false,"pushed_at":"2026-04-15T11:50:39.000Z","size":40,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-15T12:19:30.150Z","etag":null,"topics":["agents-md","agentsmd","ai-agent","ai-coding","ai-coding-assistant","anthropic","automation","bash","cc-agents-md","claude","claude-code","claude-code-plugin","cli","coding-agent","developer-tools","monorepo","nodejs","open-source","self-hosted","sessionstart-hook"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GeiserX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"geiserx","patreon":"geiser","buy_me_a_coffee":"geiser","thanks_dev":"u/gh/geiserx"}},"created_at":"2026-04-15T10:10:13.000Z","updated_at":"2026-04-15T11:50:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GeiserX/cc-agents-md","commit_stats":null,"previous_names":["geiserx/agents-md-loader"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/GeiserX/cc-agents-md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fcc-agents-md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fcc-agents-md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fcc-agents-md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fcc-agents-md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeiserX","download_url":"https://codeload.github.com/GeiserX/cc-agents-md/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2Fcc-agents-md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31842193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T11:29:19.690Z","status":"ssl_error","status_checked_at":"2026-04-15T11:29:19.171Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents-md","agentsmd","ai-agent","ai-coding","ai-coding-assistant","anthropic","automation","bash","cc-agents-md","claude","claude-code","claude-code-plugin","cli","coding-agent","developer-tools","monorepo","nodejs","open-source","self-hosted","sessionstart-hook"],"created_at":"2026-04-15T13:02:04.533Z","updated_at":"2026-04-15T13:02:05.509Z","avatar_url":"https://github.com/GeiserX.png","language":"JavaScript","funding_links":["https://github.com/sponsors/geiserx","https://patreon.com/geiser","https://buymeacoffee.com/geiser","https://thanks.dev/u/gh/geiserx"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/banner.svg\" alt=\"cc-agents-md banner\" width=\"900\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/GeiserX/cc-agents-md/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/GeiserX/cc-agents-md/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/cc-agents-md\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/cc-agents-md\" alt=\"npm version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-GPL--3.0-blue.svg\" alt=\"License: GPL-3.0\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nClaude 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.\n\n**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. No patches.\n\n## How It Works\n\nA `SessionStart` hook is registered in `~/.claude/settings.json`. On every new Claude Code session, the hook:\n\n1. Walks **upward** from your working directory to the git root\n2. Collects every `AGENTS.md` on the path\n3. Small files are **inlined** directly into Claude's context\n4. Large files get a **preview + read instruction** — Claude reads the full file on demand\n\n```text\nmonorepo/\n├── AGENTS.md                  ← always loaded (project root)\n├── packages/\n│   ├── frontend/\n│   │   ├── AGENTS.md          ← loaded if you're working here\n│   │   └── src/\n│   └── backend/\n│       ├── AGENTS.md          ← NOT loaded (not on your path)\n│       └── src/\n```\n\nThe depth adapts to where you are. Open Claude at the root? One file. Open it in `packages/frontend`? Two files. No scanning downward, no wasted context.\n\n## Installation\n\n```bash\nnpx cc-agents-md setup\n```\n\nThat's it. Restart Claude Code.\n\n### Verify\n\n```bash\nnpx cc-agents-md doctor\n```\n\n### Uninstall\n\n```bash\nnpx cc-agents-md remove\n```\n\n## Commands\n\n| Command   | Description                                      |\n|-----------|--------------------------------------------------|\n| `setup`   | Install the SessionStart hook globally            |\n| `remove`  | Uninstall completely (hook + script)              |\n| `status`  | Show installation state and detected AGENTS.md    |\n| `doctor`  | Full health check                                 |\n| `preview` | Print exactly what Claude would see               |\n\n## Configuration\n\n### Inline threshold\n\nFiles under 200 lines are inlined fully. Larger files get a 50-line preview + a read instruction for Claude to load the rest. Customize both:\n\n```bash\nexport AGENTS_MD_INLINE_THRESHOLD=200   # lines — inline below, preview above\nexport AGENTS_MD_PREVIEW_LINES=50       # lines shown in the preview\n```\n\n## How is this different from...\n\n### `@AGENTS.md` in CLAUDE.md\n\nThat still requires a CLAUDE.md file in every repo. Also, [imported content is followed less reliably](https://github.com/anthropics/claude-code/issues/35295) than inline instructions.\n\n### Symlink `CLAUDE.md → AGENTS.md`\n\nStill creates a CLAUDE.md file (even if it's a symlink). Doesn't handle nested AGENTS.md in monorepos.\n\n### `tweakcc`\n\nPatches Claude Code's JavaScript internals. Breaks on every update. This tool uses the stable, documented hook API.\n\n## Requirements\n\n- Claude Code (any version with SessionStart hooks)\n- Node.js \u003e= 18 (for the CLI only — the runtime hook is pure bash)\n- bash (pre-installed on macOS and Linux)\n\n## License\n\nGPL-3.0 — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fcc-agents-md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeiserx%2Fcc-agents-md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fcc-agents-md/lists"}