agentsmd
Standardize global user-level AGENTS.md at ~/.config/agents/AGENTS.md
Problem
Each AI coding tool uses a different global config path:
- Claude Code:
~/.claude/CLAUDE.md - Codex:
~/.codex/AGENTS.md - droid:
~/.factory/AGENTS.md - Amp:
~/.config/AGENTS.md
Result: Users must either duplicate personal preferences across tool-specific paths OR copy the same config into every project's ./AGENTS.md.
Solution
One standard location: ~/.config/agents/AGENTS.md
Platforms:
- Linux/macOS:
~/.config/agents/AGENTS.md($XDG_CONFIG_HOME/agents/AGENTS.md) - Windows:
%APPDATA%\agents\AGENTS.md
Why a directory (agents/) not a lone file:
- Follows XDG standard:
~/.config/<name>/(not~/.config/file) - Extensible: add
rules/,commands/, templates later - Prevents
~/.config/clutter from tool-specific files
How It Works
Tools check ~/.config/agents/AGENTS.md for global user configuration. Project-level config takes precedence over global.
Implementation details—precedence order, parent directory walking, merging behavior—are up to individual tools.
Precedent
Amp already uses ~/.config/AGENTS.md (lone file). This proposal uses the directory pattern (~/.config/agents/) for better extensibility.
Similar patterns: Git uses ~/.gitconfig (global) + .git/config (project), npm uses ~/.npmrc + .npmrc.
Reference
Full proposal: https://github.com/nijaru/global-agents-config
