Content
<p align="center">
<img src="docs/icon.png" width="120" alt="Engram">
</p>
<h1 align="center">Engram</h1>
<p align="center">
<b>One shared memory for all your AIs.</b><br>
Your assistants forget you the moment a chat ends — and each one lives in its own silo.
Engram is the memory they share.
</p>
<p align="center">
<img alt="macOS 13+" src="https://img.shields.io/badge/macOS-13%2B-1a1a2e">
<img alt="Swift 5.9" src="https://img.shields.io/badge/Swift-5.9%2B-orange">
<img alt="MCP" src="https://img.shields.io/badge/MCP-server-7c3aed">
<img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue">
</p>
## What it is
Pull your context in from any AI — a ChatGPT or Claude export, any Markdown / text / JSON, or a quick
paste — into one private, **local** memory. Then any assistant that speaks **MCP** (Claude Desktop,
Claude Code, your own apps) can `recall` it, across every conversation you've fed in. Remember once;
every connected AI knows it.
You own all of it: memories are plain **Markdown files on your Mac** (`memories/<conversation>.md`) —
readable, greppable, editable, deletable. **Nothing is ever uploaded.**
## How it works
- **One memory, many minds.** A single store every MCP client reads from and writes to. "Collective
mind" recall (`.all`) searches across all your conversations at once; or scope recall to a single
conversation, or to one named file you've grouped.
- **Bring your history in.** Import a ChatGPT / Claude export, Markdown/text/JSON, or paste — and
choose **Key facts** (keep only the durable things *you* said) or **Everything**. Auto-capture from
Claude Code transcripts is built in (opt-in).
- **Semantic recall, on device.** Embeddings run locally via Apple's Natural Language framework (an
optional one-time download upgrades to the contextual transformer). No model server, no network for
recall.
- **Native, and yours.** A real **native macOS app** (SwiftUI + AppKit — no Electron, no web
wrapper). Local-first by design: no account, no telemetry, no analytics. The only network is
**opt-in** and never sends your data — a manual "Check for Updates", an optional local-Ollama
distiller, and the one-time on-device model download. See [PRIVACY.md](PRIVACY.md).
## Install
```sh
# 1) the macOS app
bash packaging/make-app.sh # → Engram.app on your Desktop
# 2) connect the memory to Claude (MCP)
swift build -c release
.build/release/engram-mcp --connect # registers Engram with Claude Desktop
.build/release/engram-mcp --prepare-embeddings # optional: one-time on-device model for best recall
# 3) (optional) auto-capture durable facts from your Claude Code chats
.build/release/engram-capture --watch
```
Requires **macOS 13+**. No backend, no third-party services — the engine, MCP server, and capture
tool are pure Swift + Foundation.
## Engine API
```swift
let engine = try MemoryEngine(root: memoriesFolderURL)
try engine.remember("I prefer dark mode.", source: "manual", conversation: "chat-1")
let hits = engine.recall("what theme do I like", scope: .all) // collective mind
let where_ = engine.search("dark mode") // keyword → which conversation
try engine.forget(hits[0].memory.id) // soft delete (stays on disk)
```
## Build & test
```sh
swift build
swift test
```
## License
[MIT](LICENSE) © 2026 Joseph.
<p align="center"><sub>Your AIs forget. Engram remembers — and shares it.</sub></p>
