Files
openhuman/gitbooks/features/native-tools/memory-tools.md
T
2026-05-09 00:17:29 -07:00

28 lines
1.6 KiB
Markdown

---
description: How the agent reads, writes, and searches its own long-term memory.
icon: brain
---
# Memory Tools
The [Memory Tree](../obsidian-wiki/memory-tree.md) is OpenHuman's knowledge base. The memory tools are how the agent talks to it during a conversation.
## Tools in the family
| Tool | What it does |
| -------- | ----------------------------------------------------------------------------------------------------------- |
| `recall` | Search the Memory Tree by query - source-scoped, topic-scoped, or global. Returns chunks with provenance. |
| `store` | Write a new memory the agent decided is worth keeping (a fact, a preference, a piece of context). |
| `forget` | Remove a memory by ID - used when something is wrong, stale, or the user explicitly asks to forget it. |
There is also a tree-aware retrieval surface (drill down a topic, fetch the global digest for a day) - the agent picks the right one based on the question.
## Why these are tools, not implicit context
The Memory Tree is too big to dump into every conversation. The tools let the model *ask* - "what do I know about Alice?", "what happened yesterday?", "remind me of last week's Stripe webhook" - and the retrieval layer returns just the relevant chunks, with provenance back to the source file in your Obsidian vault.
## See also
* [Memory Tree](../obsidian-wiki/memory-tree.md) - what these tools read from and write to.
* [Auto-fetch](../obsidian-wiki/auto-fetch.md) - how the tree gets populated in the first place.