Skip to content
BENIBIX Learn

Hermes Context Files

AI🪽 Hermes AgentHermes Memory

Also known as .hermes.md, HERMES.md, Hermes AGENTS.md

The files in a project that tell Hermes its rules. It reads one kind per session.

Think of it like

It is like the rules on the wall of one class.

Example

Leo's repo has an AGENTS.md with the test command. Hermes reads it on start and runs the right tests without asking.

Why it matters

Project rules should live with the project. Then each agent that opens it gets them.

Definition

Context files are the files in a project that Hermes Agent reads at the start to learn its rules, such as its commands, ports and paths. It loads only one kind per session, and the first one it finds wins. The order is .hermes.md or HERMES.md, then AGENTS.md. Next come CLAUDE.md and the .cursorrules file from Cursor. The search walks up to the top of the git repo.

Common mistake

Keeping both .hermes.md and AGENTS.md and expecting both to load. Only the first match is read.

Key takeaways

  1. 1
    Project rules. In the project.
  2. 2
    One kind per session. First match wins.
  3. 3
    .hermes.md first. Then AGENTS.md.