Persistent memory for pi — the coding agent. Works with any LLM pi supports (Anthropic, OpenAI, Google, and more). Pick cloud (Memra) or local (memra-local) — same tools, same API, your choice.
Your agent forgets everything between sessions. Memra is the memory layer that fixes that.
pi install ./pi-extensionpi install npm:@usememra/pi-extensionReload with /reload.
On first session start the extension auto-detects:
MEMRA_API_KEYin env → cloud mode.- A running memra-local on
http://127.0.0.1:8765→ local mode. - Otherwise it asks you.
Cloud defaults to https://usememra.com/api and automatically talks to the public API at /v1/... and /health.
Config lives at ~/.memra/pi-extension.json (mode 0600). Nothing else is written.
| Variable | Description |
|---|---|
MEMRA_API_KEY |
Cloud API key (memra_live_...) |
MEMRA_PROJECT_ID |
Cloud project ID / namespace (default: default) |
MEMRA_TENANT_ID |
Cloud tenant ID / namespace root (default: pi-agent) |
| Command | Action |
|---|---|
/memra |
Interactive hub |
/memra status |
Active backend + health |
/memra switch |
Pick cloud or local |
/memra namespace <name> |
Set project/namespace |
/memra tenant <id> |
Set cloud tenant ID |
/memra setkey |
Set cloud API key |
/memra autorecall |
Toggle auto-recall on new turns |
/memra signup |
Open signup page |
/memra reset |
Wipe extension config |
A footer badge (☁ cloud · <project> or ⌂ local · <namespace>) shows the active backend at all times.
When auto-recall is enabled (default), the extension automatically searches your memory store before each agent turn and injects relevant memories into the LLM context. This means your agent remembers across sessions without you having to ask.
Toggle with /memra autorecall.
Every tool mirrors the Memra API surface:
| Tool | Description |
|---|---|
memra_recall |
Semantic recall by natural-language query (primary read verb) |
memra_remember |
Store a fact, decision, preference, or context (primary write verb) |
memra_get |
Fetch a single memory by ID |
memra_list |
List memories, optionally filtered by type |
memra_delete |
Delete a memory permanently |
memra_supersede |
Replace an outdated memory (preserves audit trail) |
memra_history |
View the supersession chain for a memory |
memra_health |
Check backend reachability |
memra_search |
Deprecated alias of memra_recall (still callable) |
memra_add |
Deprecated alias of memra_remember (still callable) |
The LLM picks tools automatically based on your conversation. The extension routes every call to the active backend (cloud or local).
- API key read from
MEMRA_API_KEY→~/.memra/pi-extension.json→ interactive prompt. Never logged. - Local mode is bound to loopback (
127.0.0.1/localhost) only. - Cloud mode refuses non-HTTPS URLs.
- Namespace / project / tenant inputs are validated before saving.
- Writes confined to
~/.memra/pi-extension.json.
| Cloud | Local | |
|---|---|---|
| Storage | Managed (EU, Hetzner Helsinki) | Your machine |
| Sync | Multi-device | None (use cloud for sync) |
| Offline | No | Yes |
| Setup | API key | pip install memra-local && memra-local serve |
| Price | Free tier + paid plans | Free, BUSL-1.1 (memra-local) |
Get a cloud key: usememra.com/install
For shared persistent memory across pi sessions, set:
export MEMRA_API_KEY="memra_live_..."
export MEMRA_PROJECT_ID="memra-brain"
export MEMRA_TENANT_ID="pi-agent"Then run pi and /reload.
MIT. Use it anywhere. The Memra backend (usememra.com) and memra-local server have their own licenses.
