pi-memory-vault

SQLite-backed long-term Markdown memory for Pi

Packages

Package details

extension

Install pi-memory-vault from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-memory-vault
Package
pi-memory-vault
Version
0.2.0
Published
Aug 18, 2026
Downloads
298/mo · 298/wk
Author
somaholiday
License
MIT
Types
extension
Size
43.3 KB
Dependencies
2 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-memory-vault

Requires Node.js 22.19 or newer, matching current Pi releases.

SQLite-backed long-term Markdown memory for Pi.

Install

pi install npm:pi-memory-vault

For a local checkout:

pi install /absolute/path/to/packages/pi-memory

Restart Pi, then run:

/memory init
/memory status

The extension registers memory_read, memory_write, and /memory. It works without the companion skills package.

Run /memory to browse titles and previews in a fuzzy-filtered picker, or /memory <query> to search the vault before opening the picker.

Configuration

MEMORY_VAULT selects the Markdown directory. Without it, the extension uses ~/Memory.

Search uses SQLite FTS5 BM25 by default. Set OPENAI_API_KEY to add vector search where the optional sqlite-vec package is supported. Advanced embedding settings live at $XDG_CONFIG_HOME/memory-vault/embeddings.json:

{
  "model": "text-embedding-3-small",
  "dimensions": 1536,
  "endpoint": "https://api.openai.com/v1/embeddings"
}

Git commits are optional. memory_write commits only when given a commit message and the vault is a Git repository.