Installation

Install

npm install -g @evan-moon/memex

Connect to Claude Code

memex mcp install

That's it. On first run, the embedding model (~450 MB) downloads once to ~/.memex/models/. All subsequent runs are fully offline.

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "memex": {
      "command": "node",
      "args": ["<path from `memex mcp path`>"]
    }
  }
}

Get the path with:

memex mcp path

What gets created

~/.memex/
  config.json, vault path and settings
  memex.db, SQLite database (notes + embeddings + FTS5)
  models/, cached multilingual-e5-base model

Notes are saved as plain Markdown files in your vault (default: ~/Documents/Second Brain). They're fully Obsidian-compatible.

Change the vault path

memex config set vault-path ~/my-notes

Verify the setup

memex list          # lists recent notes (empty on first run)
memex config show   # shows current config

Once you've connected memex to Claude, try asking Claude about something you've worked on. If the topic could relate to a past conversation or decision, Claude will automatically search your notes before answering.

Upgrading from an older version

On first run after upgrading, memex applies idempotent schema migrations, it adds a layer column to existing notes (folder-based backfill: projects / dev / herald → state, coding → rule, everything else → past) and a source column to note_links for the flashback feature. Run memex layer to see the resulting distribution, and memex layer <id> <layer> to correct any individual notes.

See Note layers for what each layer means.