Humans.md releases 0.3 draft specification
Understand this story
Humans.md has released the 0.3 draft specification, which lets coding agents read the ~/.humans/HUMANS.md file at the start of a session to agree on when to interrupt the user, when to decide on their own, and how questions are collected at the end of a task. The specification comes with several limitations: hosted compilation sends the file's contents to the assistant provider; a HUMANS.md placed in the repository root is never loaded; and a profile without a visibility field is read as org. In addition, the plugin's installation and in-session behavior on Copilot CLI 1.0.98 have not been tested.
AI overview based on source reports · Updated 5 hr ago
Coverage timeline
Follow the coverage to explore different perspectives.
- Hacker News AIHumans.md: tell your AI agents how to work with you
Humans.md is a draft 0.3 spec for a single file, ~/.humans/HUMANS.md, that coding agents read at session start to learn how you prefer to be written to, when to ask you to decide, and when to interrupt you. Plugins for Claude Code, Codex, Cursor, Copilot CLI, Antigravity, OpenCode and Devin load the profile, while a CLI syncs a copy for Junie, Cline and Warp; the page stresses that preferences shape how agents write to you but never grant a permission, and that repository rules and harness settings win.
Activity for this story
- Current comparable activity
- 9
- Peak comparable activity
- 10Nov 20 14:00
- Change in the past 24 hours
- –
Trends compare the same fully observed participants, which may cover fewer participants than current activity. Move the pointer or tap the chart to inspect hourly activity; use the left and right arrow keys with a keyboard.