apex-memory

# apex-memory

[![CI](https://github.com/JJerryChoi/apex-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/JJerryChoi/apex-memory/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/apex-memory.svg)](https://www.npmjs.com/package/apex-memory)
[![npm downloads](https://img.shields.io/npm/dm/apex-memory.svg)](https://www.npmjs.com/package/apex-memory)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Persistent memory for AI coding agents.**

Give your AI coding agent memory that survives across sessions. apex-memory is an [MCP](https://modelcontextprotocol.io) server that lets agents save decisions, patterns, bugs, and context — then recall them exactly when needed.

- **One install, works everywhere** — MCP-native, works with Claude Code, Cursor, Windsurf, and any MCP-compatible editor
- **Ultra-lightweight** — 26.6 kB package, starts in milliseconds, no ML models or vector databases
- **Zero infrastructure** — local SQLite database, no servers, no accounts
- **Built for coding agents** — categories like `decision`, `architecture`, `bug`, `pattern` designed for real development workflows
- **Smart memory management** — importance scoring (1-5), access tracking, and auto-decay keep your memory store relevant
- **Full-text search** — find any memory instantly with FTS5-powered search
- **Knowledge graph** — link memories with directional relationships (related, depends_on, supersedes, contradicts, extends)
- **Dedup detection** — automatic duplicate warnings on save, Jaccard similarity scanning, and one-click merge
- **Cloud sync** — sync memories across machines with the Pro tier

## Quick Start

### Claude Code

```bash
Claude MCP add apex-memory -- npx apex-memory
```

That's it. Your agent now has persistent memory.

### Cursor

Add to your MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "apex-memory": {
      "command": "npx",
      "args": ["apex-memo