Feature Request: Auto-load ~/.claude/AGENTS.md like CLAUDE.md

Problem

Currently, CLAUDE.md files are automatically loaded into Claude's context at the start of conversations (visible in system-reminder messages). However, ~/.claude/AGENTS.md is not automatically loaded, even though it's intended for user-level rules that apply across all projects.

Current Behavior

• ✅ CLAUDE.md (repository-level) is automatically loaded and shown in system-reminder
• ❌ ~/.claude/AGENTS.md (user-level) is NOT automatically loaded
• ❌ Critical rules in AGENTS.md are not in Claude's active context unless explicitly read

Expected Behavior

~/.claude/AGENTS.md should be automatically loaded into Claude's system prompt at session start, similar to how CLAUDE.md is loaded. This would ensure user-level rules (like "NEVER commit to main") are always active.

Why This Matters

User-level rules in AGENTS.md are meant to be:

• Cross-project: Apply to all repositories
• Critical: Blocking rules that should never be violated
• User-specific: Personal workflow preferences

Without auto-loading, Claude can violate these rules because they're not in active context.

Proposed Solution

Add AGENTS.md to the system context loading mechanism, possibly with a section like:

# agentRules
Contents of ~/.claude/AGENTS.md...

Similar to how CLAUDE.md is loaded as # claudeMd.

Workaround Attempted

Tried to configure via:

• settings.json - no relevant option found
• SessionStart hooks - not user-configurable
• hookify plugin - only for pattern-based blocking, not context loading

Related

This is similar to how CLAUDE.md works, but at the user level instead of repo level.