Skip to content

Your vault is the agent's memory

The agent’s long-term memory is your vault: a folder of Markdown files you can read, edit, search and version yourself. Nothing the agent “knows” between chats is hidden from you.

  • You decide what’s remembered. Knowledge reaches the vault when you save it, not as a side effect of every chat.
  • Recall shows its source. When a Prime answer uses a vault note, it’s marked From your vault, so you can open the note and check.
  • Memory is reversible. In a Git-backed vault, every saved or edited note is a change you can diff and revert.
  • Memory is portable. It’s plain Markdown. Open it in another editor, sync it with Git, or keep it if you stop using Rhizome.
  1. Chat. You and the agent work on something. Chat transcripts are working memory. They live with the session, not in the vault.
  2. Save. Under a reply worth keeping, click Save to vault. Rhizome writes a Markdown note.
  3. Recall. The native engine can search and open vault notes in later chats with grep, read_file, list_dir, and glob.
  4. Review. Open, edit or delete the note like any other. With Git, look at its history and revert a change.

Save to vault appears under a reply. It writes the note straight away. There’s no preview or diff step, so review the note afterwards, or use Git to undo it.

It refuses to save when:

  • The reply is empty. There’s nothing to save.
  • No vault is attached to the chat. It says “Attach a vault to save chat into notes”.
  • The text contains a credential, such as an API key or password. Vault notes are committed and can be pushed, so remove the secret first.
  • The same reply is already in the vault. It names the existing note and doesn’t overwrite it.

Settings → AI Agents → Auto-save chat knowledge to the vault saves durable decisions to the vault after each turn. It’s off by default. Turn it on only if you want saves to happen without a click. Explicit saves are easier to trust.

You can import your Claude Code chat history from Settings → AI Agents → Import chat history. Rhizome scans ~/.claude/projects on your Mac. The chats become notes under Imports/claude-code/ in the vault. A second import skips chats that are already there. Claude Code is the only source today.

Git turns the vault into memory with a history:

  • Diff: see what a note said before the agent or you changed it.
  • Revert: undo one change without touching the rest.
  • Sync: push the vault to a remote you control. Rhizome uses your system Git login.

Git is optional. A plain folder works, but it has no history to go back to. See Git.

A vault can hold an AGENTS.md file with your conventions: how notes are named, which types to use, what to avoid. The agent reads it before it works in the vault. CLAUDE.md is kept as a compatibility copy for tools that look for that name.

WhatKept inYou can
Saved notesThe vaultRead, edit, diff, revert, sync
Imported Claude Code chatsImports/claude-code/ in the vaultRead, edit, link
Chat transcripts (Prime)~/.prime/agent/sessions/Resume from the sessions list
Chat transcripts (Rhizome’s engine)native-sessions/ in the app config folderResume from the sessions list
Vault activity log.rhizome/events.jsonl in the vaultInspect