Memory and knowledge

Your assistant builds a persistent memory of who you are and what matters to you. It also supports a knowledge base where you can upload documents for retrieval-augmented generation (RAG).

How memory works

After each conversation, the assistant automatically extracts key information and stores it as memories. You do not need to tell the assistant to remember something explicitly -- it does so on its own.

Memories have a relevance score that increases when the assistant references them and decays over time. This ensures frequently useful information stays prominent while stale facts fade naturally.

Memory categories

Category	What it captures	Examples
Fact	Objective information about you	"Lives in San Francisco", "Works at Acme Corp"
Preference	How you like things done	"Prefers concise answers", "Likes morning meetings"
Episodic	Events and experiences	"Had a dentist appointment on March 12"

Viewing and editing memories

Open Assistant > Memory in the dashboard to browse, search, edit, or delete individual memories. Each memory shows its category, source (conversation or manual edit), and relevance score.

You can also search memories via the API:

curl -X POST https://api.fold.run/memories/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "meeting preferences", "limit": 10 }'

Knowledge base

The knowledge base lets you upload documents that the assistant can search when answering questions. Documents are chunked, embedded, and stored for semantic retrieval.

To add a document, go to Assistant > Knowledge and click Upload. Supported sources:

• File upload -- paste or upload a text document.
• URL -- provide a URL and the content is fetched and indexed.
• Paste -- paste text directly into the editor.

Documents go through a processing step (chunking and embedding) before they are searchable. Status is shown as processing, ready, or error.

Contacts

The assistant maintains a contact list under Assistant > Contacts. Contacts store a name, relationship, context notes, email, and phone number. The assistant references contacts when drafting emails or discussing people you mention in conversation.

Notes

Personal notes are available under Assistant > Notes. Notes support tags for organization and are searchable by the assistant during conversations.