Hermes Agent's BOOT.md is not executed, most often not because of a file syntax error, but because you think of it as a global script that "any entry will read". The official Hooks documentation makes it clear: the built-in boot-md only checks for ~/.hermes/BOOT.md when the gateway starts, not every time the CLI is opened.
To make it work, you must first meet 2 conditions
- The file location must be
~/.hermes/BOOT.md. - You start the Hermes gateway, not just a CLI session.
There is another point that is easy to overlook
The official documentation states that it will be executed in a background thread; If it finally decides that "no notice is necessary", it returns [SILENT], and it looks like nothing happened. So "no bullet news" does not necessarily mean not running.
In a word: BOOT.md is the gateway startup hook, not the CLI opener; If the position and trigger timing are wrong, it will not run.
Official open source address: https://github.com/NousResearch/hermes-agent; Official document entry: https://hermes-agent.nousresearch.com/.
