Show HN: Agentsmd – Local preferences and templates for AGENTS.md (github.com)

🤖 AI Summary
Agentsmd is a small CLI (npm package @adiasg/agentsmd) that helps developers keep local agent instructions, preferences and reusable templates layered on top of a repository’s canonical AGENTS.md without committing personal tweaks. You write a local .agentsmd and optionally reusable snippets in ~/.agentsmd/templates/<name>.md, then run agentsmd make to rebuild AGENTS.md by appending your overlay (and inlining {{name}} tokens). It’s aimed at projects that use AGENTS.md for agent/assistant guidance so each contributor can keep private preferences (e.g., “Never run npm run dev”) while the shared file remains clean and authoritative. Technical details: install with npm install -g @adiasg/agentsmd and use commands like agentsmd make, agentsmd enable/disable, and agentsmd status. Rendering requires Python 3. agentsmd enable installs Git hooks (pre-commit, post-merge, post-checkout), a merge driver that prefers the remote AGENTS.md, a git alias (git rebuild-agents), and marks AGENTS.md assume-unchanged; disable restores original hooks and removes state in .git/agentsmd-state/. All changes stay local—no remote services or global state—so teams get reproducible, conflict-reducing automation for agent guidance while preserving private, per-developer overlays.
Loading comments...
loading comments...