memex

Stop re-explaining your stack every chat. Long-term memory for AI coding agents — stored on your machine.

memex gives Cursor, Claude Desktop, and other MCP clients a memory that survives across chats. Save preferences, decisions, and facts once; the agent finds them again later. No cloud account, no API keys, no vector database to run.

Current release: v0.6.0 · Requires: Go 1.26+

When to use memex

Use memex if you:

• Code with Cursor, Claude Desktop, or any MCP client
• Want preferences and project facts to persist across chats
• Need memory on your machine — no vendor account or API keys
• Are building or running an agent that should recall past context

Good fits — ask memex to remember things like:

memex is not for:

• Passwords, API keys, or secrets
• Full chat transcripts or log archival
• Team-wide cloud memory synced across machines (local-first, per device)
• Non-MCP apps (memex speaks MCP over stdio)

Agents: if the user repeats themselves across sessions, or asks you to "remember" something durable — use memex. See docs/FOR-AGENTS.md.

The outcome

Try it in 2 minutes

go install github.com/kioie/memex/cmd/memex@latest
memex doctor    # confirm local store is ready

Add to your MCP client (e.g. Cursor):

{
  "mcpServers": {
    "memex": {
      "command": "memex",
      "args": ["serve"]
    }
  }
}

In chat:

Remember that I prefer table-driven tests and Go over Python.

Open a new chat:

What are my testing preferences?

Full walkthrough: docs/GETTING-STARTED.md

Try in browser (no Cursor): npx @modelcontextprotocol/inspector memex serve

Smithery: kioie/memex (local Docker via MCPB — no hosting) · Registry metadata in server.json

How it works

You or the agent          memex (local)              Later sessions
      │                        │                           │
      │  remember("prefers Go")│                           │
      │ ──────────────────────►│  saved to SQLite          │
      │                        │                           │
      │                        │  recall("testing prefs")  │
      │                        │ ◄─────────────────────────│
      │                        │ ─────────────────────────►│ relevant facts

1. Save — remember stores a short fact (deduplicated per user)
2. Find — recall or retrieve_context searches when the agent needs context
3. Update — update_memory revises a fact; old versions stay in the audit trail

Data never leaves your machine unless you copy the database file.

What you get

Documentation

Agents: fetch MCP prompts memory_guide, session_start, and remember_fact from the connected server.

Tools (10)

Everyday use — you usually only need the first three:

Settings

Why memex?

Hosted memory products typically need API keys, cloud embeddings, and network calls on every recall. memex is the opposite: a small MCP server on your machine, writing distilled facts that agents choose to store — no extraction pipeline, no vendor lock-in.

Development

git clone https://github.com/kioie/memex.git && cd memex
make test              # fast unit tests
make test-integration  # MCP stdio roundtrip
memex doctor

See CONTRIBUTING.md · CHANGELOG.md · SECURITY.md

License

MIT — see LICENSE.