Skip to content
BENIBIX Learn

Hermes USER.md

AI🪽 Hermes AgentHermes Memory

Also known as USER.md, Hermes user profile

The Hermes file about you and what you like.

Think of it like

It is like a card a helper keeps about you.

Example

Leo tells Hermes he likes short answers in metric units. It saves both to USER.md, and every later chat follows them.

Why it matters

You should not have to explain yourself again in every new chat.

Definition

USER.md is the file where Hermes Agent keeps what it knows about you, such as your name, your job and how you like replies. It sits next to MEMORY.md in ~/.hermes/memories and holds up to 1,375 characters by default. The agent writes it with the same memory tool. It loads at the start of each session, like MEMORY.md.

Example code

console
cat ~/.hermes/memories/USER.md
See what the agent knows about you.

Common mistake

Writing facts about yourself in SOUL.md. That file is the agent's voice; USER.md is about you.

Key takeaways

  1. 1
    About you. Not the agent.
  2. 2
    1,375 characters. By default.
  3. 3
    Written by the agent. Via the memory tool.

Compare