memex MCP工具

Prerequisites

• VS Code / Copilot: No prerequisites — the extension bundles everything
• Claude Code: No prerequisites — the plugin handles everything
• Pi: Requires Node.js 18+ and npm install -g @touchskyer/memex
• All other platforms (Cursor, Codex, Windsurf, etc.): Requires Node.js 18+

Install

Step 1: Add memex to your editor

Note: If you use Claude Code inside VS Code, follow the Claude Code row — not "VS Code / Copilot". The VS Code extension serves GitHub Copilot only; Claude Code has its own plugin system.

That's it — no extra setup needed. The MCP tool descriptions tell your agent when to recall and retro.

安装

第一步：添加 memex 到编辑器

注意： 如果你在 VS Code 里使用 Claude Code，请按照 Claude Code 那一行操作，而非"VS Code / Copilot"。VS Code 扩展仅服务于 GitHub Copilot；Claude Code 有自己的 plugin 系统。

安装完成，无需额外配置。MCP 工具描述会自动告诉 agent 何时 recall 和 retro。

---

Configuration

Optional settings go in ~/.memex/.memexrc (JSON):

{
  "nestedSlugs": true,
  "searchDirs": ["shared"],
  "experimental": {
    "agenticMemory": true
  }
}

Experimental: Agentic Memory

When experimental.agenticMemory is true, agents gain access to a structured memory skill that guides them through: observe → draft atomic card → enrich metadata → retrieve candidates → decide (create/update/skip) → preview → write → verify.

This produces higher-quality cards with agent-proposed [[wikilinks]] (links are suggested after candidate retrieval and agent review, never added from keyword or embedding similarity alone) and metadata enrichment, compared to the default recall/retro workflow. The feature is default-off and does not change any existing behavior when disabled.

See skills/memex-agentic-memory/SKILL.md for the full skill specification and docs/ARCHITECTURE.md for config details.

---

CLI reference

memex search [query]          # search cards, or list all
memex read <slug>             # read a card
memex write <slug>            # write a card (stdin)
memex links [slug]            # link graph stats
memex archive <slug>          # archive a card
memex serve                   # visual timeline UI
memex sync                    # sync via git
memex mcp                     # start MCP server (stdio)