hn.today

Claude Code reads AGENTS.md only when telemetry is on

blog.szypowi.cz477 points280 comments
Screenshot of Claude Code reads AGENTS.md only when telemetry is on

Claude Code 2.1.277/2.1.280 added support for AGENTS.md project instructions, but that loader is gated behind a remote feature flag (tengu_agents_md_mod) and is off by default. When telemetry or nonessential traffic is disabled, the plugin never becomes available and a local AGENTS.md is silently ignored. Tests using a canary file (containing the word PERIWINKLE) show that CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 and DISABLE_TELEMETRY=1 both block loading; setting those variables to 0 or adding an env block in .claude/settings.json does not re-enable the feature, while a session-level override works only from the second session onward. Third-party gateways (Bedrock, Vertex) suffer the same fate because they cannot resolve the flag, and no warning is printed when a file is skipped.

This is presented as unacceptable because a privacy choice should not silently disable reading a local file; users who disable telemetry expect reduced external communication, not loss of purely local functionality. The practical workaround is to add a one-line CLAUDE.md that imports AGENTS.md (@AGENTS.md) or to symlink ~/.agents/skills into .claude/skills, but that undermines the purpose of AGENTS.md. Recommended fixes are to stop tying local file reads to telemetry, at minimum emit a startup warning when AGENTS.md is present but skipped, and add support for a global AGENTS.md and native shared skills paths.

Read on blog.szypowi.cz280 comments on Hacker News

Summary generated by AI from the linked article. hn.today is not affiliated with Hacker News or Y Combinator.

More in AI

The daily digest

Today's best Hacker News stories, summarized and screenshotted, one email a day.