# Hermes MEMORY.md

> The file of notes Hermes keeps for itself. It loads when each session starts.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** MEMORY.md, Hermes memory tool

## Think of it like

It is like the notes a helper sticks on their own desk.

## Definition

MEMORY.md is the file where Hermes Agent keeps its own notes. They are facts about your machine, your projects and odd tool habits. It lives in ~/.hermes/memories and holds up to 2,200 characters by default. The agent writes it with the memory tool. When each session starts, its notes go into the system prompt as a frozen copy.

## Example

Hermes learns that Mia's server runs Ubuntu with Docker. It saves that in MEMORY.md, so it never has to ask again.

## Example code

```console
cat ~/.hermes/memories/MEMORY.md
```

See what the agent has saved.

## Why it matters

A fact it needs on every run should not cost a question each time.

## Common mistake

Trusting a reply that says it saved something. Only a real memory tool call writes the file, so check it.

## Three principles

- **The agent's notes.** It writes them.
- **2,200 characters.** By default.
- **Frozen at session start.** Changes show next time.

## Related terms

- [Hermes USER.md](https://learn.benibix.com/term/ai/hermes-user-md)
- [Hermes Learning Loop](https://learn.benibix.com/term/ai/hermes-learning-loop)
- [session_search Tool](https://learn.benibix.com/term/ai/hermes-session-search)
- [Agent Memory](https://learn.benibix.com/term/ai/agent-memory)
- [Hermes Memory Providers](https://learn.benibix.com/term/ai/hermes-memory-providers)
- [Hermes Context Compression](https://learn.benibix.com/term/ai/hermes-context-compression)

## Told apart from

- [Hermes Memory vs session_search](https://learn.benibix.com/compare/hermes-memory-md-vs-hermes-session-search): People think Hermes forgets anything not saved to memory. It does not. Memory is a few key facts loaded into every prompt, so it is small on purpose. session_search looks through every past chat on demand, at no model cost. Save the facts it needs every time, and let search find the rest.
- [Hermes Memory vs Hermes Skill](https://learn.benibix.com/compare/hermes-memory-md-vs-hermes-skill): People think memory and skills both just store things the agent learned. In fact, each one stores a very different kind of thing. Memory holds short facts and is loaded into every prompt. A skill holds a whole method, step by step, and is loaded only when a task needs it. Put a fact in memory, and a how-to in a skill.

![Four files shape Hermes: SOUL.md says who the agent is, USER.md who you are, MEMORY.md what it has learned, and AGENTS.md what the project needs.](https://learn.benibix.com/diagrams/hermes-memory-files.svg)

---

Source: https://learn.benibix.com/term/ai/hermes-memory-md
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
