# 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 -->


## Quick Use

Add the following to `.mcp.json`:

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

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

---

## Intro

Engram is an agent-agnostic persistent memory system with 2,300+ GitHub stars. A single Go binary backed by SQLite + FTS5 full-text search, exposing MCP server, HTTP API, CLI, and TUI interfaces. It gives long-term, cross-session memory to Claude Code, Cursor, Aider, or any other AI coding agent. Ideal for developers tired of re-explaining project context every time.

---

## Source & Thanks

> 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/engram-persistent-memory-system-ai-agents-f5bac4b3
Author: MCP Hub