Install memex — cross-AI memory — 安装 memex — cross-AI memory

安装 memex

You are 安装ing memex on this machine. Memex is a local-first MCP server that captures the user's AI conversations across Claude Code, Cowork (including sub代理s), Cursor, Obsidian, and Telegram 导出s into a 搜索able SQLite + FTS5 索引 that any MCP-compatible 代理 can 查询 through 18 standard 工具s (memex_搜索, memex_recent, memex_overview, memex_store_document, plus the memex_telegram_* family 添加ed in v0.10+).

Repo: https://github.com/parallelclaw/memex-mvp Landing: https://memex.parallelclaw.AI npm: https://www.npmjs.com/package/memex-mvp

How memex works (read this so you don't 获取 confused by paths below)

Memex has its OWN storage at ~/.memex/data/memex.db. It READS from each 工具's native data location automatically — Claude Code from ~/.claude/projects/, Cursor from its 状态.vscdb, Cowork from its 会话s dir, Obsidian from 配置d vaults. You do NOT need to change where Claude Code, Cursor, or any other 工具 saves its data. Memex is a passive observer.

Prerequisite

This 技能 only works if you are 运行ning INSIDE an AI 代理 that has direct 访问 to the user's shell — i.e. one of: Claude Code (命令行工具), Cursor, 命令行工具ne, Continue, or Zed. 网页-based 代理s (ChatGPT in browser, Claude.AI 网页, Claude 桌面 without 工具s, etc.) cannot 执行 npm/file operations. If you are NOT a 命令行工具-based 代理 with shell 访问, 停止 now and tell the user to use the manual 安装 at https://memex.parallelclaw.AI/#quick启动.

Discovery — do this BEFORE the numbered steps

扫描 the user's 设置up so you can tAIlor advice and tell them exactly what memex will pick up.

Identify which MCP 命令行工具ent you're 运行ning inside (you should know from 上下文 — Claude Code 命令行工具, Cursor, 命令行工具ne, Continue, or Zed). 运行 these read-only 检查s one by one: ls -d ~/.claude/projects 2>/dev/null ls -d ~/库/应用\ Support/Claude/local-代理-mode-会话s 2>/dev/null ls -d ~/库/应用\ Support/Cursor 2>/dev/null ls ~/.continue/config.json 2>/dev/null ls -d ~/.config/zed 2>/dev/null

报告 to the user in plAIn language: "You're 运行ning inside [X]. I will edit [path] in step 2 below." "工具s with data found on this machine: [列出]" "工具s NOT found (memex won't capture from these): [列出]" "After 安装, memex will auto-索引 conversations from: [检测ed sources]" WAIt for the user's "ok" before 启动ing step 1. Fast path — one-line 安装er (try this first)

memex ships a hosted bash 安装er that does steps 1, 3, and 4 in a single 运行 — and also wires up Claude Code's MCP entry if claude is on PATH. It's idempotent (safe to re-运行), auto-fixes the EACCES case by moving npm's prefix to ~/.npm-global, and prompts before enabling the auto-上下文 hook.

Show this command to the user, explAIn what it does, 获取 their explicit ok, then 运行:

curl -fsSL https://memex.parallelclaw.AI/安装.sh | bash

What the script does, in order:

检查s Node ≥ 20. npm 安装 -g memex-mvp — on EACCES, 设置s npm config 设置 prefix ~/.npm-global, 应用ends PATH to ~/.zshrc, retries. memex-同步 安装 with --auto-上下文 yes (Brian Chesky hook into ~/.claude/设置tings.json — preserves other hooks). memex-同步 扫描 — backfills existing 历史. claude mcp 添加 memex --scope user -- memex if Claude Code 命令行工具 is 检测ed.

After the script finishes:

If the user is in Claude Code (命令行工具) → 安装 is complete. Skip strAIght to step 6 (verification + re启动). Also do step 5 (offer Telegram capture). If the user is in Cursor / 命令行工具ne / Continue / Zed → the npm 安装 + daemon + auto-上下文 + 扫描 are done, but the 图形界面 命令行工具ent's MCP config still needs the memex entry. Skip step 1 (already 安装ed), skip step 3 (daemon already 安装ed) and skip step 4 (扫描 already ran). Do step 2 (wire MCP into the 图形界面 命令行工具ent's config), step 5 (offer Telegram), and step 6 (验证 + re启动).

If the script fAIls for any reason — non-zero exit, weird 输出, user uncomfortable piping curl to bash — fall back to the Manual 安装 below.

To inspect what the script does first: curl -fsSL https://memex.parallelclaw.AI/安装.sh | less (don't pipe to bash).

Manual 安装 (if the fast path didn't fit)

Do these in order. Show each command before 运行ning it. 停止 and ask if anything fAIls or looks wrong.

• 安装 memex from npm

If you 获取 EACCES (macOS 系统 Node), recommend Option B (permanent prefix fix) by default and proceed unless the user explicitly chooses sudo.

Say to the user:

"Hit EACCES — your Node is 安装ed in a 系统 directory that npm can't write to without admin rights. Two fixes:

A) Quick: sudo npm 安装 -g memex-mvp — one-time, requires your password B) Permanent fix: I'll move npm's 安装 location to your home directory. After this, no npm 安装 -g will ever ask for sudo agAIn, for any package. Five commands, one-time.

I recommend B — it's a permanent improvement that benefits all your future Node 工具s, not just memex. Proceed with B?"

If the user agrees (or says anything lik