Skip to content
BENIBIX Learn

SOUL.md vs USER.md (Hermes)

People think SOUL.md is where facts about them go. It is not. SOUL.md sets who the agent is, its tone and style, and you write it yourself. USER.md holds who you are, your name and how you like replies, and the agent writes it. The two never feed each other.

AI🪽 Hermes Agent

Hermes SOUL.md

The file you write to set how Hermes talks and acts.

SOUL.md is the file that sets who Hermes Agent is: its personality, tone and style. It lives in the Hermes home folder, not in your project, and comes first in the system prompt. Hermes makes a starter file if there is none, and never writes over yours. You write it yourself. For a change that lasts one session, use the /personality command instead.

Example
Sara wants a calm, plain-spoken assistant. She rewrites SOUL.md to say so, and every chat after that sounds that way.
Why it matters
It is the one place that decides how the agent sounds, everywhere it runs.
Full entry
AI🪽 Hermes Agent

Hermes USER.md

The Hermes file about you and what you like.

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
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.
Full entry

In one line

Hermes SOUL.md
The file you write to set how Hermes talks and acts.
Hermes USER.md
The Hermes file about you and what you like.