Skip to content
BENIBIX Learn

Hermes SOUL.md

AI🪽 Hermes AgentHermes Memory

Also known as SOUL.md, Hermes personality

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

Think of it like

It is like the part an actor plays: who they are, and how they talk.

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.

Definition

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 code

console
hermes config edit
$EDITOR ~/.hermes/SOUL.md
Open the agent's identity file.

Common mistake

Putting project rules in SOUL.md. Those belong in AGENTS.md in the project.

Key takeaways

  1. 1
    Who the agent is. Tone and style.
  2. 2
    First in the prompt. Slot one.
  3. 3
    You write it. Hermes never overwrites.

Compare