# Engram — Persistent Memory System for AI Agents

> Agent-agnostic persistent memory system with SQLite full-text search. Ships as MCP server, HTTP API, CLI, and TUI. Gives any AI coding agent long-term memory across sessions. 2,300+ stars.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "engram": {
      "command": "engram",
      "args": ["mcp"]
    }
  }
}
```

Install the binary: `go install github.com/Gentleman-Programming/engram@latest`

Or use via CLI: `engram remember "Always use kebab-case for file names in this project"`

---

## Intro

Engram is an agent-agnostic persistent memory system that gives AI coding agents long-term memory across sessions with 2,300+ GitHub stars. Built as a single Go binary with SQLite + FTS5 full-text search, it ships as an MCP server, HTTP API, CLI, and TUI — so it works with Claude Code, Cursor, Aider, Codex, and any MCP-compatible tool. Your agent remembers decisions, patterns, and project context without you re-explaining every session. Best for developers tired of repeating the same context to their AI agent. Works with: Claude Code, Cursor, Aider, Codex, Gemini CLI. Setup time: under 2 minutes.

---

## How It Works

### Remember Decisions
When your agent makes a decision, store it:

```bash
engram remember "We chose PostgreSQL over MySQL for this project because of JSONB support"
engram remember "API responses always use snake_case, frontend uses camelCase"
engram remember "Never use ORM for complex queries - write raw SQL instead"
```

### Automatic Recall
When used as an MCP server, the agent automatically queries Engram for relevant context based on the current conversation:

```
User: "Set up the database schema"
Agent: [queries Engram] → recalls PostgreSQL decision, snake_case convention
Agent: "Based on our previous decisions, I'll use PostgreSQL with snake_case columns..."
```

### Full-Text Search
SQLite FTS5 provides blazing-fast full-text search across all memories:

```bash
engram search "database"  # finds all database-related memories
engram search "naming convention"  # finds style decisions
```

### Memory Categories
Organize memories by type:

```bash
engram remember --category architecture "Microservices with event-driven communication"
engram remember --category style "Use Tailwind CSS, no custom CSS files"
engram remember --category decisions "Chose Stripe over PayPal for payments"
```

### TUI Dashboard
Interactive terminal UI to browse, search, edit, and delete memories:

```bash
engram tui
```

### Key Stats
- 2,300+ GitHub stars
- Single Go binary, zero dependencies
- SQLite + FTS5 full-text search
- 4 interfaces: MCP, HTTP API, CLI, TUI
- Works with any MCP-compatible agent

### FAQ

**Q: What is Engram?**
A: Engram is a persistent memory system that gives AI coding agents long-term memory across sessions, storing decisions, patterns, and context in a local SQLite database with full-text search.

**Q: Is Engram free?**
A: Yes, fully open-source under MIT license. All data stays local on your machine.

**Q: How is Engram different from CLAUDE.md files?**
A: CLAUDE.md is static and manually maintained. Engram is dynamic — agents can read and write memories during sessions, and full-text search surfaces relevant context automatically.

---

## Source & Thanks

> Created by [Gentleman Programming](https://github.com/Gentleman-Programming). Licensed under MIT.
>
> [engram](https://github.com/Gentleman-Programming/engram) — ⭐ 2,300+

Thanks to the Gentleman Programming community for solving the AI amnesia problem.

---

<!-- ZH -->

## 快速使用

将以下配置添加到 `.mcp.json`:

```json
{
  "mcpServers": {
    "engram": {
      "command": "engram",
      "args": ["mcp"]
    }
  }
}
```

安装: `go install github.com/Gentleman-Programming/engram@latest`

---

## 简介

Engram 是一个 Agent 无关的持久记忆系统，GitHub 2,300+ stars。单个 Go 二进制文件，基于 SQLite + FTS5 全文搜索，支持 MCP 服务器、HTTP API、CLI 和 TUI 四种接口。让 Claude Code、Cursor、Aider 等任何 AI 编码 Agent 跨会话保持长期记忆。适合厌倦每次都重复解释项目上下文的开发者。

---

## 来源与感谢

> Created by [Gentleman Programming](https://github.com/Gentleman-Programming). Licensed under MIT.
>
> [engram](https://github.com/Gentleman-Programming/engram) — ⭐ 2,300+

---
Source: https://tokrepo.com/en/workflows/f5bac4b3-caff-48a5-8b6a-48de91fec697
Author: MCP Hub