The ProjectsMD dashboard plugin is designed for localhost use inside Hermes Agent.
- Intended host:
127.0.0.1 - API prefix:
/api/plugins/projectsmd - Do not expose Hermes dashboard with project mutation or tmux-control routes on
0.0.0.0unless you add network authentication and understand the risk.
project.mdremains the source of truth.- Common mutations go through allowlisted ProjectsMD CLI wrappers.
- Unsupported or agent-proposed full-file changes go through the approval queue.
- Queue approval creates a snapshot before writing.
- Project writes use a file lock to avoid concurrent edits.
- Orchestrator is the only default writer to
project.md. - Subagents should emit structured
PROJECT_*protocol lines and propose queued updates. - Tmux runs use the real Hermes CLI command shape:
hermes chat -q '<prompt>' -s projectsmd --pass-session-idSafety policies block destructive command patterns such as:
rm -rfgit push --forcegit reset --harddd if=/of=/dev/sudois treated as requiring review
The bundle contract forbids:
innerHTMLdangerouslySetInnerHTMLalert()prompt()location.reload
User-controlled strings render through React text nodes.