open-memex MCP server

open-memex

Persistent memory for your AI coding agents — on your machine, in plain Markdown, shared by every tool you code with.

中文文档

Every AI coding session starts from zero: you re-explain the project, the agent rediscovers the same gotchas, and yesterday's decisions vanish when the chat ends. open-memex gives your agents a memory that survives the session. Say "remember: we deploy on Fridays" once, and next week Copilot, Cursor, opencode, or Claude Code already knows — because they all read and write the same local memory on your machine.

everything lives on your machine, in files you can open and edit.

• Free and open source (Apache-2.0). No account, no cloud, no telemetry —

a rebuildable SQLite keyword index. Nothing leaves your machine unless you explicitly share it.

• Local-first: memories are plain Markdown files (the source of truth) with

share the same memory instead of keeping separate silos.

• One memory, every agent: wire up several editors with one command; they

a curated multilingual map of equivalents is indexed with every memory at write time, so no related wording misses the right answer. Deterministic and auditable, no embedding model required.

• Precise synonym search: ship finds deploy, 单点登录 finds SSO —

New here? This README takes you from install to a working memory in about a minute. The concept guide explains the mental model in depth once you're up and running.

Contents

• Quick start
• Core concepts
• Which editors, which features
• Installation
• Setting up your editor
• What init changes on your machine
• Capture: how memories get saved
• Tools the agent gets
• Memory types
• Team workflow: sharing memories through Git
• Retrieval: how memories come back
• Security & data

Quick start

You need Node.js ≥ 22.14 (check with node -v). Then:

npm install -g open-memex
open-memex init

init detects the editors you have installed (VS Code, Cursor, opencode, and Visual Studio when your project has a solution file) and connects each one to open-memex. Restart your editor afterwards.

See it work (30 seconds):

open-memex add "This project deploys on Fridays"

Now open a new chat in your editor and ask your agent: "When does this project deploy?" It already knows — no re-explaining. That round trip, capture once and recall forever, is the whole product. Everything below is detail.

Optional but recommended — check everything is wired up:

open-memex doctor

Core concepts

Three ideas explain almost everything open-memex does.

Shortened. The full README is on GitHub.