Skip to content
BENIBIX Learn

session_search Tool

AI🪽 Hermes AgentHermes Memory

Also known as Hermes session search, Hermes state.db

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

Think of it like

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

Example

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

Why it matters

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

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 code

console
hermes sessions list
Browse the chats the tool can search.

Common mistake

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

Key takeaways

  1. 1
    Every chat stored. In state.db.
  2. 2
    Real messages. No summary.
  3. 3
    No model cost. About 20 ms.

Compare