Memory

Pia’s Memory is the personal knowledge it builds up about you — your preferences, the people and projects you mention, important dates — and draws on to give you answers that fit you better.

Everything is stored in a vault: a folder of plain Markdown files on your computer. Pia owns and writes these files, but they’re just text — you can read, edit, or open them yourself at any time.

How memory works

• Pia remembers automatically. While you chat, it quietly records useful things. New memories appear in the Memory view on their own — you don’t have to save anything.
• You stay in control. Select a memory to read it, change its text, or delete it so Pia stops using it.
• Search understands meaning, not just exact words — describe what you’re looking for.
• It’s all local. Your memories are files in the vault’s memory folder on this computer.

Browsing your memories

Open Memory from the sidebar. The left column lists your memories, grouped into collapsible categories:

• Personal Profile, Contacts, Preferences, Notes, Projects
• Topics — knowledge pages, further split into People, Organizations, Products, Concepts, Regulations, Technology, and Other

Each group header shows a count and when it was last updated; items inside are sorted by title. If you haven’t built up any memory yet, you’ll see “No memories yet — Chat with Pia to start building memory.”

The toolbar at the top has buttons to go Back/Home, Refresh, Open memory vault, and open the help dialog (“How memory works”).

Vault at a glance

When nothing is selected, the right-hand panel shows Vault at a glance — a Composition by category bar that visualizes how your memory breaks down, with a colour-coded legend and counts.

Below it is the Source documents list — your own files that Pia has compiled into knowledge. See Documents & Auto-Ingest for how to add them.

Reading a memory

Click a memory to open it in the inspector. You’ll see its type, title, and when it was last updated, with the content rendered as formatted Markdown.

• Links between pages — [[double-bracket]] links are clickable; use Back and Home to navigate between pages the way you would in a browser.
• Copy — copy the memory’s raw text to the clipboard.

Editing a memory

Click Edit to open the memory’s Markdown in a text editor, make your changes, and click Save. Pia updates just that memory and leaves the rest of the file untouched.

To remove a memory, click Delete and confirm. Pia will no longer use it.

Note

Editing is now direct Markdown — there’s no separate form or JSON editor. If you’d rather edit in your own tools, click Open memory vault and edit the files directly.

Searching

Use the search bar above the list to find memories. If an embedding model is available, Pia uses hybrid search (meaning + keywords) for more accurate results; otherwise it falls back to keyword matching. The status bar at the bottom shows whether the embedding model is Ready and which model is in use.

@ Commands

In the Assistant chat, type @ to reference memories directly in your message:

Syntax	Example	Description
@Memory	@Memory	Point the assistant at your memory and topic pages
@Memory:Name	@Memory:ProjectAlpha	Reference a specific memory
@Memory:"Multi Word"	@Memory:"My Project"	Quote titles with spaces

You can also use @Todo and @Reminder to reference those items. An autocomplete popup appears as you type.

Where your memories live

The vault lives at <your assistant files folder>\Vault and contains two folders:

• memory/ — the memories you see in the Memory view.
• sources/ — your own documents that Pia reads for reference (see Documents & Auto-Ingest).

Click Open memory vault in the Memory view to open this folder. You can move it to a different location — see General Settings → Assistant files and memory folder.

Storage and sync

Your memory vault is stored as plain files on this device. Conversations and todos sync across your devices when Cloud Sync is enabled (end-to-end encrypted on Pro plans).