What is Engram?

An end-to-end encrypted memory layer for AI assistants.

LOCAL BY DEFAULT - Your data lives on your device. No cloud, no servers, no sync unless you ask for it.

ENCRYPTED ALWAYS - AES-256-GCM. Keys never leave your device. 24-word recovery phrase, like a crypto wallet.

ZERO-KNOWLEDGE SYNC - Need multi-device? Opt-in sync encrypts everything client-side. We only see ciphertext. Like Signal, but for AI memory.

OPEN SOURCE - Don't trust us. Verify. Audit the code. Self-host if you want. Fork if we disappear.

Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

Quick Start

npx engram-core init

Restart your AI client. It remembers you now.

Features

Feature	Description
Local by Default	Your data stays on your device. No cloud required.
E2E Encryption	AES-256-GCM. Keys never leave your device.
Open Source	Audit the code. Self-host. Fork if we disappear.
Semantic Memory	Vector similarity search across all your sessions
Secrets Vault	Encrypted storage for API keys and credentials
Zero-Knowledge Sync	Optional. Client-side encryption. We only see ciphertext.

Architecture

+---------------------------------------------------------------+
|                          AI CLIENTS                           |
|                                                               |
|   +-------------+    +-------------+    +-------------+       |
|   |   Claude    |    |   Cursor    |    |   Claude    |       |
|   |   Desktop   |    |             |    |    Code     |       |
|   +------+------+    +------+------+    +------+------+       |
|          |                  |                  |               |
|          +------------------+------------------+               |
|                             |                                  |
|                             v                                  |
|                  +--------------------+                        |
|                  |    MCP Protocol    |                        |
|                  +---------+----------+                        |
|                            |                                   |
+----------------------------+-----------------------------------+
                             |
                             v
+---------------------------------------------------------------+
|                        ENGRAM SERVER                          |
|                                                               |
|   +-------------+    +-------------+    +-------------+       |
|   |   Memory    |    |   Secrets   |    |   Session   |       |
|   |   Store     |    |   Vault     |    |   Watcher   |       |
|   +-------------+    +-------------+    +-------------+       |
|                                                               |
+----------------------------+----------------------------------+
                             |
                             v
                  +---------------------+
                  |       SQLite        |
                  |     ~/.engram/      |
                  |                     |
                  |   Your data stays   |
                  |     on YOUR disk    |
                  +---------------------+

Security

All encryption uses node:crypto (OpenSSL). No custom cryptography.

Layer	Algorithm
At Rest	AES-256-GCM
Key Derivation	PBKDF2-SHA256 (600k iterations)
Search Index	HMAC-SHA256 (blind indexing)
Recovery	BIP39 Mnemonic (24 words)

Why Not Cloud Memory?

	Engram	Cloud Memory
Where's your data?	Your device (default)	Their servers
Who holds the keys?	You	They do
Can they read it?	No	Yes
Can you verify?	Yes (open source)	No
Cross-app	Any MCP client	Locked to one app

Philosophy

The AI industry solved intelligence. It forgot about sovereignty.

Memory is infrastructure, not a feature
Encryption is a right, not a premium tier
If you can't export it, you don't own it

Claude Code Agent Teams Integration

Engram integrates with Claude Code Agent Teams through lifecycle hooks. When teams complete tasks or wind down, Engram can automatically consolidate team memories into structured summaries.

How it works:

Agents save memories tagged with team:<name> during work
Hooks trigger engram consolidate at key moments (task completion, teammate idle)
Consolidation categorizes memories into findings, decisions, hypotheses, blockers, and action items
Summaries are saved as searchable team-summary memories for future sessions

Configuration (.claude/settings.json):

{
  "hooks": {
    "TaskCompleted": [
      "engram consolidate"
    ],
    "TeammateIdle": [
      "engram consolidate"
    ]
  }
}

You can also run engram consolidate manually to generate team summaries on demand.

Engram

README