How SOUL.md works now
Hermes Agent's personality is fully customizable. is the primary identity — it's the first thing in the system prompt and defines who the agent is. — a durable
Hermes Agent's personality is fully customizable. is the primary identity — it's the first thing in the system prompt and defines who the agent is. If you want to change who Hermes is — or replace it with an entirely different agent persona — edit . …
What this page covers
- How SOUL.md works now
- Important behavior
- Why this design
- Where to edit it
- What should go in SOUL.md?
- Good SOUL.md content
- Example
- What Hermes injects into the prompt
- Security scanning
- SOUL.md vs AGENTS.md
- SOUL.md
- AGENTS.md
- SOUL.md vs /personality
- Built-in personalities
- Switching personalities with commands
- CLI
- Messaging platforms
- Custom personalities in config
- Recommended workflow
- How personality interacts with the full prompt
- Related docs
- CLI appearance vs conversational personality
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Core Features
Features Overview
Hermes Agent includes a rich set of capabilities that extend far beyond basic chat. From persistent memory and file aware context to browser automation and voic
Tools & Toolsets
Tools are functions that extend the agent's capabilities. They're organized into logical toolsets that can be enabled or disabled per platform. Available Tools
Skills System
Skills are on demand knowledge documents the agent can load when needed. They follow a progressive disclosure pattern to minimize token usage and are compatible
Curator
The curator is a background maintenance pass for agent created skills . It tracks how often each skill is viewed, used, and patched, moves long unused skills th
Persistent Memory
Hermes Agent has bounded, curated memory that persists across sessions. This lets it remember your preferences, your projects, your environment, and things it h
Memory Providers
Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. On