# session_search Tool

> The Hermes tool that searches all your past chats. It costs no model calls.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** Hermes session search, Hermes state.db

## Think of it like

It is like looking back through old texts to find what was said.

## Definition

session_search is the Hermes Agent tool that searches all your past chats. Every chat is stored in a SQLite database, ~/.hermes/state.db, that can search all its text. A search gives back the real messages, with no summary and nothing cut. It takes about 20 milliseconds and makes no model calls. Memory holds the key facts, and this finds the rest.

## Example

Mia asks which database they picked last month. Hermes searches past sessions, finds the chat and quotes the answer.

## Example code

```console
hermes sessions list
```

Browse the chats the tool can search.

## Why it matters

Memory is small on purpose. Search lets the agent recall the rest without filling every prompt.

## Common mistake

Saving all things to memory so none are lost. Past chats can already be searched.

## Three principles

- **Every chat stored.** In state.db.
- **Real messages.** No summary.
- **No model cost.** About 20 ms.

## Related terms

- [Hermes MEMORY.md](https://learn.benibix.com/term/ai/hermes-memory-md)
- [SQLite](https://learn.benibix.com/term/development/sqlite)

## 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.

---

Source: https://learn.benibix.com/term/ai/hermes-session-search
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.
