dgr8akki/engram

Engram

A local-first personal knowledge base with semantic search, built to work natively with Claude Code, Cursor, Antigravity, and Windsurf via MCP.

Everything runs on your machine — no cloud, no API costs, no data leaving your computer.

Features

• Semantic search — find thoughts by meaning, not keywords
• MCP integration — Claude Code, Cursor, and Antigravity can read and write your knowledge base mid-conversation
• Auto-memory hooks — sessions automatically inject recent memories on start and save notes on end
• Auto-save triggers — say "remember: ..." and your note is saved instantly
• HTTP REST server — fallback for tools that don't support MCP
• Dual embedding backends — sentence-transformers (offline) or Ollama

Quick Start

git clone https://github.com/dgr8akki/engram
cd engram
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
./engram init
./engram install

engram install does three things in one shot:

1. Registers the MCP server for each detected tool
2. Installs the agent skill (tells LLMs how to use Engram)
3. Installs session-lifecycle hooks (auto memory read/write)

Then restart your IDE and Engram is active.

CLI Usage

./engram add "GraphQL subscriptions leak memory if you forget to unsubscribe"
./engram add "Prefer useReducer over useState for complex form state" --tags react,patterns
./engram search "memory leak javascript"
./engram list --limit 20
./engram delete 42
./engram stats
./engram -h          # help
./engram -V          # version

AI Tool Usage

Once installed, your AI coding tool can use Engram through natural conversation:

| You say | What happens | |---|---| | "remember: prefer Zod over Yup for schema validation" | Auto-saved immediately | | "what do I know about React patterns?" | Searches your knowledge base | | "show my recent thoughts" | Lists last 20 entries | | "save this: always check for null before accessing .data" | Saved to E