Локальная память для всего что ты говоришь AI — и выбранных Telegram-чатов. Один файл на твоём ноутбуке. Любой агент (Claude, Cursor, Cline, …) читает из одной памяти.
curl -fsSL https://memex.parallelclaw.ai/install.sh | bash
One line in your terminal. Auto-fixes npm permissions, installs daemon + Brian Chesky auto-context hook. Idempotent. Read the script.
Copy the prompt → paste into Claude Code, Cursor, Cline, Continue or Zed → AI installs everything itself.
Половина твоих решений живёт в Telegram. Теперь AI читает их вместе с тобой.
Экспорт → memex ловит сам → AI спрашивает что импортить. 30 секунд. Privacy-first.
Открой любой чат → ⋮ → Export chat history → HTML или JSON. Это всё что от тебя нужно.
Daemon следит за ~/Downloads/Telegram Desktop/. Через ~7 секунд после экспорта — macOS-banner: «1 new chat ready to review».
Открой Claude (или кликни banner) — первая реплика: «Вижу: Семья · Работа · Психолог. Импортировать? Психолога пропусти.»
Что Аня говорила про дизайн презентации в марте?
Нашёл в чате «Конференция Q2» (Telegram, 23 марта):
Аня: «давай минималистичнее — белый фон, только тезисы. Тёмная версия для титульной»
Аня также предложила Helvetica. Ты согласился, но сказал «проверить читаемость в зале».
Вытащи из рабочего чата за последний месяц: что висит на мне, что заблокировано, кто ждёт ответа.
Из чата «Работа» (1,847 сообщений, 16 апр → 16 мая):
🔒 Privacy-first: ты выбираешь каждый чат сам. Психолога или банк — пропускаешь одним кликом. Block patterns (*bank*) для целых категорий. Локальный SQLite, никуда не уходит.
Что спросишь первым?
Конкретные сценарии — копируй промпт, вставляй в свой AI-агент. Каждый показывает что memex реально даёт.
Экспортируй чат с клиентом из Telegram Desktop (чат → ⋮ → Export chat history) — JSON или HTML. v0.10+ memex сам найдёт экспорт в ~/Downloads/, спросит какие чаты импортить — скажи «import family and work». Дальше в Claude / Cursor:
→ Агент найдёт релевантные сообщения, прочитает контекст и выдаст структурированный план. Ты перестаёшь вручную перечитывать три месяца переписки.
Вчера в Claude Code обсуждал архитектуру. Сегодня открываешь Cursor:
→ Cursor через MCP читает сессию Claude Code. Контекст переходит между AI без повторных объяснений.
Сделал 20 минут research'a в Perplexity. Не хочешь, чтобы он остался в одной вкладке навсегда. (v0.6+)
→ Агент fetch'ит страницу (для Cloudflare-блока auto-falls back на r.jina.ai — memex учит трюку), вызывает memex_store_document, хранит verbatim. Ищется из любого AI-чата. Работает для любых URL — Perplexity, блог-постов, ChatGPT/Gemini share'ов, Twitter, GitHub discussions.
Возвращаешься к проекту после паузы — вместо копания в git log и заметках:
→ Агент собирает картину из последних сессий по этому project_path. (Примечание: Brian Chesky auto-context хук делает это сам — этот сценарий для случая когда явно спрашиваешь.)
Маркетолог два месяца назад прислал deck про Q2 launch в Telegram, потом команда комментировала. Готовишь презентацию руководству:
→ Memex находит deck + обсуждение вокруг него, агент читает PDF, выдаёт готовую basis для презентации.
Решал что-то про pricing два месяца назад и не помнишь точную формулировку:
returns original messages — not a paraphrase, exact quote with date and source session."
data-ru="→ memex_search(\"pricing\") возвращает оригинальные сообщения — точную цитату с датой и из какой сессии.">
→ memex_search("pricing") возвращает оригинальные сообщения — точную цитату с датой и из какой сессии.
Любопытно где тема всплывала в твоём стеке:
→ 1 запрос → агент видит все упоминания через все инструменты, группирует по темам.
Через полгода, когда понадобится точная цитата — она будет на месте.
Другие AI-memory инструменты сжимают разговоры в AI-сгенерированные summary. Точные формулировки — слова Claude'a, твои примеры кода, ход обсуждения — теряются. memex хранит дословно. Навсегда.
→ Через полгода: помнишь что посоветовали RLS. А точное обоснование Claude'a? Детали про JWKS-ротацию? Кодовые примеры? Потеряны.
как делать auth для multi-tenant?
Для multi-tenant auth я бы рекомендовал три подхода:
1) Tenant-isolated JWT — каждый tenant имеет свой key set, ротация через JWKS endpoint, Redis-кэш 5min TTL...
2) PostgreSQL Row-Level Security — RLS policies на tenant_id, проверка на каждый query, индексы по tenant_id обязательны...
3) Database-per-tenant — самый изолированный но дорогой...
Я бы выбрал #2 — лучший cost/isolation trade-off для большинства SaaS до 1000 tenants.
→ Через полгода: каждое слово на месте. Цитируешь. Перечитываешь JWKS-детали. Копируешь код. Ищешь по фразе. Оригинал целый.
Поэтому memex.db разрастается. Это компромисс. AI-summary инструменты экономят токены при recall'е; memex сохраняет саму информацию. Сжатие необратимо — из verbatim всегда можно сделать summary, обратно — никогда.
Иногда не хочется звать AI — хочется просто открыть и увидеть всё самому.
Одна команда — memex web --open. Локальный read-only веб-просмотрщик корпуса. 5 страниц, ~30KB клиентского бандла, те же verbatim chat-bubbles что выше.
Статы корпуса, sources breakdown, последние 10 чатов, callout про pending Telegram — всё за один взгляд.
Live FTS5-поиск через htmx (debounce 200мс). Фильтры-чипы по source. Кол-во hit'ов на каждый чат.
Каждое сообщение — chat-bubble'ом, то самое что не делает claude-mem (он только AI-резюмирует). Поиск внутри чата с подсветкой. Пагинация для чатов 1000+.
Telegram-экспорты ждущие решения. Чекбоксы для bulk Import / Skip — тот же privacy-gate, что и в memex telegram import.
Daemon status, путь и размер БД, установленные хуки, decision counts. Read-only — destructive операции живут в CLI специально.
Opt-in (не always-on), read-only по умолчанию, localhost-only по умолчанию (127.0.0.1). Для remote — memex web --public --token …. Без build-step'a; raw Node http + tagged templates + htmx — поэтому весь клиентский bundle ≈ 30KB (для сравнения, у claude-mem'а viewer тащит ~10MB React'a).
Common questions about scope, devices, and privacy.
Жёсткие требования (без них memex не запустится):
brew install node или nvm.
xcode-select --install) — нужны для нативной сборки better-sqlite3, если для твоей Node-версии нет prebuilt binaries.
Известные ограничения:
npx memex-sync install работает только на macOS (LaunchAgent). На Linux запускай npx memex-sync в foreground или сделай свой systemd unit.
✅ Положительное «ограничение»: Internet не нужен после установки. Никаких phone-home, никаких API-ключей, никаких облачных зависимостей. Это feature, не bug.
✅ Что memex делает: Живёт только на твоей машине, никуда не звонит, без API-ключей, без network access. OS-level права — читает только твой user.
❌ Что не делает: Не шифрует БД, не редактирует секреты которые ты вставлял в чаты, нет пароля на сам memex.
📦 Не добавляет риск — концентрирует. Твоя AI-история уже на диске в plain text (Claude Code JSONL, Cursor state.vscdb, Cowork files, Obsidian markdown, Telegram local DB). Memex консолидирует в один SQLite. Те же данные, в одном месте вместо пяти.
🛡️ Топ-рекомендация: FileVault. На macOS: System Settings → Privacy & Security → FileVault → Turn On. Full-disk AES-256 на уровне OS — закрывает ~80% реалистичных угроз (украденный ноут, кража backup, malware без root). На Linux то же делает LUKS.
Самый быстрый способ — на конкретных примерах. Открой HELP.md в репозитории — там 6 типовых сценариев с копи-пейст промптами (Telegram-чат → action plan, cross-AI bridge, точная цитата, возврат к проекту, поиск паттернов, анализ deck'a), полный reference по всем MCP-тулзам и troubleshooting.
Или просто скажи своему AI-агенту: «Прочитай HELP.md из репозитория memex-mvp и расскажи что я могу делать с memex». Агент сам прочитает файл и пройдётся по сценариям.
Memex не зависит от твоего provider-аккаунта — читает файлы которые уже на твоём диске. Даже после бана твои Claude Code сессии в ~/.claude/projects/ остаются на месте. Memex индексирует их и отдаёт через MCP любому локально доступному AI (Llama, Qwen, или Claude через другой аккаунт). Твоя работа переживает канал доступа.
У нативной AI-памяти пять структурных дыр. Memex закрывает все пять:
project-фильтр в поиске, default — широкий. Граница на каждый запрос — твой выбор.
Источники: anthropics/claude-code #36561, #39195, #25739; HN #47853021 (тред про апрельские баны 2026).
Memory-рынок 2026 — большой и разделённый. Каждый продукт хорош в своём — memex намеренно играет в другую нишу.
| memex | Mem0 | claude-mem | ChatGPT Memory | Anthropic Memory | |
|---|---|---|---|---|---|
| Audience | AI power user, own archive | Devs building AI agents | Solo dev in Claude Code | Every ChatGPT user | Every Claude user |
| What's stored | Verbatim (raw) | Extracted facts | AI-compressed obs | Vendor-controlled | Filesystem |
| Claude's exact replies stored | ✓ Word-for-word | ✗ | ✗ Only AI-summary | ✗ | ✗ |
| Where | On your laptop | Cloud / complex self-host | On your laptop | Vendor's cloud | Vendor's cloud |
| Sources | 5 (incl. Telegram) | AI chats only | Claude Code only | ChatGPT only | Claude only |
| LLM API key required | ✗ Never | ✓ + billing | ✓ Claude/Gemini/OpenRouter | bundled | bundled |
| Outbound network at runtime | ✓ Zero | ✗ Cloud calls | ✗ LLM call per observation | ✗ | ✗ |
| Works air-gapped | ✓ | ✗ | ✗ Needs LLM | ✗ | ✗ |
| Recovery after ban | ✓ Reads from disk | ✗ if cloud | ~ Claude Code only | ✗ | ✗ |
| Cost | $0 forever | $19–249/mo | $0 | bundled | bundled |
| Open source | ✓ MIT | ✓ Apache 2.0 | ✓ MIT | ✗ | ✗ |
Да. ~/.memex/data/memex.db — обычный SQLite-файл. Три команды на старом ноуте, три на новом — вся история переезжает вместе с FTS5-индексом. Точные команды — в README → Миграция между устройствами.
Memex живёт на одной машине — daemon ловит локальные файлы, SQLite строится локально. Три паттерна для multi-device сегодня:
~/.memex/data/memex.db — обычный файл, реплицируй через iCloud / Syncthing / rsync. Daemon пишет на основной машине, остальные читают через свой локальный memex MCP. Один writer, много readers.
~/.memex/inbox/ основной машины.
iCloud setup на macOS:
export MEMEX_DIR="$HOME/Library/Mobile Documents/com~apple~CloudDocs/memex"
⚠ Только один writer. Auto-capture daemon (memex-sync) запускай ровно на одной машине, остальные только читают. Параллельные writer'ы через filesystem sync могут корраптнуть WAL.
Сегодня: memex ловит только то что на твоём ноуте. Phone-based AI (ChatGPT mobile, Claude iOS) и web-only сессии (Claude.ai web, ChatGPT в браузере) не пишут файлы тебе на диск — memex'у нечего читать.
Workaround'ы: Для Telegram-ботов — ручной export → дроп в inbox. Для ChatGPT — export данных через Settings, парсер в roadmap'е.
Roadmap: Telegram-бот (код написан в bot/) для mobile capture — пересылаешь мысли и сообщения с телефона, индексируется автоматически на ноуте.
Одна папка под каждый источник. Одна SQLite-база. Любой MCP-совместимый агент может её спрашивать. Диаграмма ниже показывает весь pipeline — от файловых watchers до MCP-tool-вызовов.
Быстрее всего — curl одной строкой в самом верху страницы. Или — пусть AI-агент поставит сам. Другие пути (вручную, skill, CLI-режим) — ниже.
Already chatting with a CLI agent (Claude Code / Cursor / Cline / Continue / Zed) on your laptop? It installs memex in 2 minutes — clones the repo, wires the MCP config, turns on auto-capture. Web agents (ChatGPT, Claude.ai) can't do this — for them, use the manual install below.
Install memex on this machine. Memex is a local-first AI memory tool — it captures my AI conversations across Claude Code, Cowork (including subagents), Cursor, Obsidian, and Telegram exports into a searchable SQLite index that any MCP-compatible agent can query through 11 standard tools. Repo: https://github.com/parallelclaw/memex-mvp
How memex works (read this so you don't get confused by paths below): memex has its OWN storage at ~/.memex/data/memex.db. It READS from each tool's native data location automatically — Claude Code from ~/.claude/projects/, Cursor from its state.vscdb, Cowork from its sessions dir, Obsidian from configured vaults. You do NOT need to change where Claude Code, Cursor, or any other tool saves its data. Memex is a passive observer.
⚠ Prerequisite: this prompt only works if you are running INSIDE an AI agent that has direct access to my laptop's shell (terminal) — i.e. one of: Claude Code (CLI), Cursor, Cline, Continue, or Zed. Web-based agents (ChatGPT in browser, Claude.ai web, Claude Desktop without tools, etc.) cannot execute git/npm/file operations on my machine — for those, point me to the manual install at https://memex.parallelclaw.ai/#quickstart instead. If you are NOT a CLI-based agent with shell access, stop now and tell me to use the manual install path.
Discovery (do this BEFORE the numbered steps): scan my setup so you can tailor advice and tell me exactly what memex will pick up.
- Which MCP client are you running inside? Look at your own context. You should be one of: Claude Code CLI, Cursor, Cline (in VS Code), Continue, or Zed.
- Which AI tools have data on this machine? Run these read-only checks one by one:
- Claude Code data: ls -d ~/.claude/projects 2>/dev/null
- Claude Cowork data: ls -d ~/Library/Application\ Support/Claude/local-agent-mode-sessions 2>/dev/null
- Cursor data: ls -d ~/Library/Application\ Support/Cursor 2>/dev/null
- Continue config: ls ~/.continue/config.json 2>/dev/null
- Zed config: ls -d ~/.config/zed 2>/dev/null
- Then report to me in plain language:
- "You're running inside [X]. I will edit [path] in step 2 below."
- "Tools with data found on this machine: [list]"
- "Tools NOT found (memex won't capture from these): [list]"
- "After install, memex will auto-index conversations from: [detected sources]"
- Wait for my "ok" before starting step 1.
FAST PATH (try this first). Memex ships a hosted bash installer that handles install + EACCES auto-fix + daemon + auto-context hook + history backfill, and also calls `claude mcp add memex` if Claude Code CLI is detected. It's idempotent — safe to re-run.
Show me this command, explain what it does, wait for my explicit "ok", then run:
curl -fsSL https://memex.parallelclaw.ai/install.sh | bash
What the script does, in order:
1. Checks Node ≥ 20.
2. `npm install -g memex-mvp` — on EACCES, moves npm prefix to `~/.npm-global` and retries (no sudo).
3. `memex-sync install` with `--auto-context yes` — adds Brian Chesky SessionStart hook to `~/.claude/settings.json` (preserves other hooks).
4. `memex-sync scan` — backfills history from Claude Code, Cowork, Cursor, Obsidian.
5. `claude mcp add memex --scope user -- memex` if `claude` is on PATH.
After it finishes:
- If I'm inside **Claude Code (CLI)** → install is done. Jump straight to step 5 (verify + restart).
- If I'm inside **Cursor / Cline / Continue / Zed** → install + daemon + scan are done, but the GUI client's MCP config still needs the memex entry. **Skip steps 1, 3, 4** of the manual flow below; **do step 2** (wire MCP into the GUI config) and **step 5** (verify + restart).
If the script errors, prints anything weird, or I'm uncomfortable piping curl to bash — fall back to the manual five-step install below. To inspect the script first instead of executing it: `curl -fsSL https://memex.parallelclaw.ai/install.sh | less`.
MANUAL FIVE-STEP INSTALL (if the fast path didn't fit). Do these in order. Show each command before you run it. Stop and ask if anything fails or looks wrong.
1. Install memex
- Run: npm install -g memex-mvp
- If EACCES (macOS system Node): RECOMMEND the permanent prefix fix (Option B) by default. Say to me: "Hit EACCES — your Node is installed in a system directory. Two fixes: (A) sudo one-time, or (B) move npm's install location to your home dir permanently — no sudo ever needed again for any future `npm install -g`. I recommend B. Proceed with B?". If I agree (or say ok/yes/go/default/B), run the 5 commands without asking again:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g memex-mvp
Only fall back to `sudo npm install -g memex-mvp` if I explicitly pick A or say sudo/fast/quick.
- If `node` or `npm` are missing — STOP and tell me to install Node.js (recommend nvm.sh or `brew install node`). Don't install Node yourself.
Verify: `which memex` prints an absolute path; `memex-sync --help` runs without error.
2. Wire memex into my MCP client
- You're running inside one of: Claude Code, Cursor, Cline, Continue, Zed.
Tell me which one you've inferred and which config file you'll edit.
Common locations:
Claude Code → ~/.claude/config.json (or platform-specific equivalent)
Cursor → ~/.cursor/mcp.json
Cline → VS Code settings.json (cline.mcpServers)
Continue → ~/.continue/config.json
Zed → ~/.config/zed/settings.json (context_servers)
If unclear, ask me.
- Read the existing config (if present). Show me a diff before saving.
- Get the ABSOLUTE path to the memex binary — GUI apps (Cursor, Cline, Claude Desktop) on macOS often don't inherit shell PATH, so a bare "command": "memex" fails with `spawn memex ENOENT`. Run:
which memex
Capture that path (e.g. /Users/<you>/.npm-global/bin/memex or /usr/local/bin/memex). If it's a shim — also run `realpath $(which memex)` to resolve to the real binary.
- MERGE this entry into mcpServers — never overwrite other servers I have:
{
"mcpServers": {
"memex": {
"command": "<absolute path from which memex>"
}
}
}
One path, no args. The published npm package wires up its own entry point.
- If the config file doesn't exist, create the parent directory and write a minimal valid file with just memex.
Verify: re-read the file after save; confirm memex entry is present and `command` is an absolute path.
3. Turn on live auto-capture (recommended)
- Run: memex-sync install
- Then: memex-sync status — should print "daemon installed", "running (PID …)", "watching N sessions".
Verify: status output shows a non-zero PID.
4. Backfill existing history (recommended on first install)
- The daemon only catches NEW sessions going forward. To index everything already on disk, run:
memex-sync scan
- This walks ~/.claude/projects/, Cowork sessions, Cursor state.vscdb, and any configured Obsidian vaults once, ingesting whatever exists.
- Optionally also: memex-sync backfill-projects — tags older conversations with their project_path so memex_list_projects works on them.
Verify: after scan, memex-sync status shows a non-zero "ingested" count.
5. Tell me what to do next
- Tell me to fully quit and reopen the MCP client (Cmd+Q on macOS) so it picks up the new memex tools.
- After restart, suggest I try any of these:
• "show me what memex has in memory" — triggers memex_overview
• "what projects has memex captured" — triggers memex_list_projects
• "search memex for [recent topic I worked on]" — triggers memex_search
These confirm everything works end-to-end.
Safety rules — read these before starting:
- If `node` or `npm` aren't installed, stop and tell me to install Node.js (recommend nvm.sh). Don't try to install Node yourself.
- Never run rm, sudo, or anything destructive without explicit confirmation from me.
- Show every command before running it. If I say "no" or "stop", halt and explain.
- If a step fails, do NOT auto-retry or auto-fix — tell me what failed and ask how to proceed.
- When editing my MCP config, always preserve existing entries. If you can't merge cleanly, abort and tell me.
- Do NOT modify the host application's settings beyond adding the memex entry to its mcpServers config. Specifically: do not redirect where Cursor / Claude Code / any other tool saves its data. Memex reads from each tool's native location automatically. The only file you should touch is the MCP config file listed in step 2.
- Stay focused on the main install task. If we get sidetracked into a sub-task (changing workspace, fixing an unrelated config issue, looking up something else), once it's done you MUST return to the memex install and explicitly tell me: "OK, back to memex install. We were at step N — should I continue?". Don't go silent after a side task. Don't assume I want to abandon the install — always confirm.
Begin by greeting me, confirming which MCP client I'm using, and running the Discovery checks before any install actions. After Discovery, propose the FAST PATH (curl one-liner) first — it covers ~90% of cases in one shot. Only fall back to the manual five-step install if I object, the script fails, or you're inside a GUI client (Cursor/Cline/Continue/Zed) where step 2 still needs to be done manually after the script runs.
Установи memex на этой машине. Memex — это local-first AI memory tool: захватывает мои разговоры с AI в Claude Code, Cowork (включая субагентов), Cursor, Obsidian и Telegram-экспорты в поисковый SQLite-индекс, доступный любому MCP-совместимому агенту через 11 стандартных тулзов. Репо: https://github.com/parallelclaw/memex-mvp
Как memex работает (прочитай это чтобы не запутаться в путях ниже): memex имеет СВОЁ хранилище в ~/.memex/data/memex.db. Он ЧИТАЕТ из нативной директории каждого инструмента автоматически — Claude Code из ~/.claude/projects/, Cursor из его state.vscdb, Cowork из его sessions-директории, Obsidian из настроенных vault'ов. Тебе НЕ нужно менять куда Claude Code, Cursor или любой другой инструмент сохраняет свои данные. Memex — passive observer.
⚠ Условие: этот промпт работает только если ты запущен ВНУТРИ AI-агента с прямым доступом к терминалу моего ноутбука — то есть Claude Code (CLI), Cursor, Cline, Continue или Zed. Web-агенты (ChatGPT в браузере, Claude.ai web, Claude Desktop без тулзов и т.п.) не могут выполнять git/npm/файловые операции на моей машине — для них направь меня к ручной установке на https://memex.parallelclaw.ai/#quickstart. Если ты НЕ CLI-агент с доступом к shell — остановись прямо сейчас и скажи мне использовать manual install.
Discovery (сделай ДО пронумерованных шагов): просканируй мою среду, чтобы дать целевые советы и сказать что memex реально подхватит.
- В каком MCP-клиенте ты запущен? Посмотри на свой контекст. Ты должен быть в одном из: Claude Code CLI, Cursor, Cline (в VS Code), Continue или Zed.
- Какие AI-инструменты есть у меня на диске? Запусти read-only команды по одной:
- Данные Claude Code: ls -d ~/.claude/projects 2>/dev/null
- Данные Claude Cowork: ls -d ~/Library/Application\ Support/Claude/local-agent-mode-sessions 2>/dev/null
- Данные Cursor: ls -d ~/Library/Application\ Support/Cursor 2>/dev/null
- Конфиг Continue: ls ~/.continue/config.json 2>/dev/null
- Конфиг Zed: ls -d ~/.config/zed 2>/dev/null
- Доложи мне плэйн-языком:
- "Ты запущен в [X]. Я буду править [путь] в шаге 2 ниже."
- "Инструменты с данными на этой машине: [список]"
- "Не найдены (memex их не захватит): [список]"
- "После установки memex автоматически проиндексирует разговоры из: [найденные источники]"
- Жди моего «ok» перед стартом шага 1.
FAST PATH (попробуй сначала это). У memex есть hosted bash-установщик который делает install + EACCES auto-fix + daemon + auto-context хук + бэкфилл истории, и ещё вызывает `claude mcp add memex` если Claude Code CLI найден на машине. Идемпотентный — безопасно перезапускать.
Покажи мне команду, объясни что она делает, дождись моего явного «ok», потом запусти:
curl -fsSL https://memex.parallelclaw.ai/install.sh | bash
Что делает скрипт, по порядку:
1. Проверяет Node ≥ 20.
2. `npm install -g memex-mvp` — при EACCES сам переносит npm prefix в `~/.npm-global` и ретраит (без sudo).
3. `memex-sync install` с `--auto-context yes` — добавляет Brian Chesky SessionStart-хук в `~/.claude/settings.json` (другие хуки не трогает).
4. `memex-sync scan` — бэкфиллит историю из Claude Code, Cowork, Cursor, Obsidian.
5. `claude mcp add memex --scope user -- memex` если `claude` на PATH.
Когда скрипт отработал:
- Если я внутри **Claude Code (CLI)** → установка готова. Сразу прыгай к шагу 5 (verify + restart).
- Если я внутри **Cursor / Cline / Continue / Zed** → install + daemon + scan готовы, но MCP-конфиг GUI-клиента всё ещё нужно дописать. **Пропусти шаги 1, 3, 4** ручного флоу ниже; **сделай шаг 2** (впиши memex в MCP-конфиг GUI-клиента) и **шаг 5** (verify + restart).
Если скрипт упал, выдал что-то странное, или мне некомфортно делать curl | bash — перейди на ручную установку из пяти шагов ниже. Чтобы посмотреть скрипт сначала, а не запускать: `curl -fsSL https://memex.parallelclaw.ai/install.sh | less`.
РУЧНАЯ УСТАНОВКА (если fast path не подошёл). Сделай эти пять шагов по порядку. Показывай каждую команду перед запуском. Останавливайся и спрашивай если что-то падает или выглядит не так.
1. Установка memex
- Запусти: npm install -g memex-mvp
- Если EACCES (системный Node на macOS): РЕКОМЕНДУЙ permanent prefix-fix (Option B) по дефолту. Скажи мне: «Hit EACCES — твой Node стоит в системной директории. Два пути: (A) sudo разово, или (B) перенести npm install location в твою домашнюю папку навсегда — sudo никогда больше не понадобится ни для одного `npm install -g`. Рекомендую B. Делаем B?». Если я согласился (или сказал ок/да/B/default/go), запусти 5 команд без дополнительных вопросов:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g memex-mvp
Используй `sudo npm install -g memex-mvp` только если я явно выбрал A или сказал sudo/быстро/quick.
- Если `node` или `npm` не установлены — ОСТАНОВИСЬ и скажи мне поставить Node.js (рекомендую nvm.sh или `brew install node`). Не пытайся ставить Node сам.
Проверь: `which memex` печатает абсолютный путь; `memex-sync --help` выводит справку без ошибок.
2. Подключи memex к моему MCP-клиенту
- Ты запущен в одном из: Claude Code, Cursor, Cline, Continue, Zed.
Скажи в каком ты и какой config-файл будешь править.
Стандартные локации:
Claude Code → ~/.claude/config.json (или platform-specific эквивалент)
Cursor → ~/.cursor/mcp.json
Cline → VS Code settings.json (cline.mcpServers)
Continue → ~/.continue/config.json
Zed → ~/.config/zed/settings.json (context_servers)
Если неясно — спроси меня.
- Прочитай существующий config (если есть). Покажи мне diff перед сохранением.
- Определи АБСОЛЮТНЫЙ путь к memex-бинарнику — GUI-приложения (Cursor, Cline, Claude Desktop) на macOS часто не наследуют PATH из shell'a, поэтому голое "command": "memex" падает с `spawn memex ENOENT`. Запусти:
which memex
Запомни этот путь (например /Users/<you>/.npm-global/bin/memex или /usr/local/bin/memex). Если это shim — дополнительно выполни `realpath $(which memex)` чтобы получить реальный бинарник.
- СМЕРДЖИ эту запись в mcpServers — никогда не перетирай другие серверы которые у меня есть:
{
"mcpServers": {
"memex": {
"command": "<абсолютный путь из which memex>"
}
}
}
Один путь, без args. Опубликованный npm-пакет сам прописал entry point.
- Если config-файла нет — создай parent-директорию и запиши минимальный валидный файл только с memex.
Проверь: перечитай файл после сохранения; убедись что memex-запись на месте и `command` — абсолютный путь.
3. Включи live auto-capture (рекомендуется)
- Запусти: memex-sync install
- Потом: memex-sync status — должен напечатать "daemon installed", "running (PID …)", "watching N sessions".
Проверь: status показывает не-нулевой PID.
4. Backfill существующей истории (рекомендуется при первой установке)
- Daemon ловит только НОВЫЕ сессии. Чтобы проиндексировать всё что уже на диске:
memex-sync scan
- Это один раз обходит ~/.claude/projects/, Cowork-сессии, Cursor state.vscdb, и любые сконфигурированные Obsidian-vaults, ингестируя что есть.
- Опционально также: memex-sync backfill-projects — простит project_path старым conversation'ам чтобы memex_list_projects работал и на них.
Проверь: после scan memex-sync status показывает не-нулевой "ingested" счётчик.
5. Скажи мне что делать дальше
- Скажи мне полностью закрыть и переоткрыть MCP-клиент (Cmd+Q на macOS) чтобы он подхватил новые memex-тулзы.
- После рестарта предложи попробовать любое из:
• «покажи что memex видит в моей истории» — вызовет memex_overview
• «какие проекты memex захватил» — вызовет memex_list_projects
• «найди в memex [недавняя тема]» — вызовет memex_search
Это подтверждает что всё работает end-to-end.
Правила безопасности — прочитай перед началом:
- Если `node` или `npm` не установлены — остановись и скажи мне поставить Node.js (рекомендую nvm.sh). Не пытайся ставить Node сам.
- Никогда не запускай rm, sudo или что-либо деструктивное без явного подтверждения от меня.
- Показывай каждую команду перед запуском. Если я говорю «нет» или «стоп» — останавливайся и объясняй.
- Если шаг падает — НЕ авто-ретрай, НЕ авто-фикс. Скажи что упало и спроси как продолжать.
- При редактировании моего MCP-config'a всегда сохраняй существующие записи. Если не можешь смерджить чисто — прерывайся и говори мне.
- НЕ модифицируй настройки host-приложения за пределами добавления memex'a в его mcpServers-config. В частности: не редиректь куда Cursor / Claude Code / любой другой инструмент сохраняет свои данные. Memex сам читает с нативных мест каждого инструмента. Единственный файл который ты должен трогать — это MCP-config из шага 2.
- Не теряй фокус на основной задаче установки. Если мы отвлеклись на побочную задачу (смена рабочей области, исправление какой-то другой проблемы, поиск чего-то ещё) — после её завершения ОБЯЗАТЕЛЬНО вернись к установке memex и явно скажи мне: «Окей, возвращаемся к установке memex. Мы были на шаге N — продолжаем?». Не уходи в пассивный режим после побочной задачи. Не предполагай что я хочу бросить установку — всегда уточняй.
Начни с приветствия, подтверди в каком MCP-клиенте я тебя запустил, и сделай Discovery-проверки перед любыми install-действиями. После Discovery — предложи сначала FAST PATH (curl one-liner), он покрывает ~90% случаев одним запуском. Возвращайся на ручную установку из 5 шагов только если я отказался, скрипт упал, или ты внутри GUI-клиента (Cursor/Cline/Continue/Zed) где после скрипта всё равно нужно дописать MCP-конфиг (шаг 2).
Each step shows where it happens. You only do this once.
npm install -g memex-mvp
If you get EACCES (macOS system Node): either sudo npm install -g memex-mvp once, or fix the prefix permanently — npm config set prefix ~/.npm-global + add ~/.npm-global/bin to PATH.
In Terminal, get the absolute path to the memex binary npm just installed:
which memex # → your-memex-path
Open ~/.claude/config.json and paste — replace the placeholder with the actual path:
{
"mcpServers": {
"memex": {
"command": "your-memex-path"
}
}
}
Why absolute path? GUI apps (Cursor, Cline, Claude Desktop) on macOS often don't see your shell PATH, so a bare "memex" fails with spawn memex ENOENT. Always use the path from which memex. Cursor, Cline, Continue, Zed have similar config files — same JSON shape.
memex-sync install
Small background process — catches every new Claude Code / Cowork session within ~1.5 seconds. Install once, forget it.
memex-sync status
Should print daemon running (PID …), watching N sessions. Restart the MCP client (Cmd+Q + reopen). Ask: «show me what memex has in memory» — that triggers memex_overview.
Drop the install-memex skill once. From then on, just say "install memex" (or "/install-memex") in any Skills-aware agent — Claude Code, OpenClaw — and it walks you through everything.
mkdir -p ~/.claude/skills/install-memex
curl -fsSL https://raw.githubusercontent.com/parallelclaw/memex-mvp/main/skills/install-memex/SKILL.md \
-o ~/.claude/skills/install-memex/SKILL.md
Works for any agent that reads ~/.claude/skills/ (Claude Code) or its own equivalent location (OpenClaw, Cline if configured).
install memex
Or /install-memex if your agent supports slash-commands. The skill's description field is written so the agent picks it up from natural-language requests too.
Open Claude Code in any project. Before you type anything, Claude already knows what you were working on. memex injects 500-1500 tokens of relevant context on every session start. No prompts, no searches, no tool calls — just memory.
memex-sync install
# → prompt: "Auto-context (Brian Chesky mode): Enable? [Y/n]"
# → answer Y
Bundled into the same command you already run for the auto-capture daemon. One [Y/n], not a separate step. Existing hooks (e.g. gstack) are preserved. Manage later with memex hook install/uninstall/status.
Open Claude Code in a project where you worked last week. Without typing anything, ask:
"continue where I left off"
Claude responds with: "Last week you fixed the JWT race condition, then started on the refresh-token rotation. Tester Bob hit a session-expiry edge case you didn't resolve. Want me to pick up there?" — without any tool calls. That's the Brian Chesky moment.
Currently works in Claude Code and OpenClaw (they have native SessionStart hooks). For Cursor, Cline, Continue, Zed — MCP-tool fallback ships in v0.9.0.
The same memex binary that runs as an MCP server also has a terminal mode. Useful when MCP isn't wired up in your agent, when you want to debug, or when piping into shell scripts.
memex search "Postgres migration"
memex search "Q2 deck" --chat "Memex Bot"
memex search "JWT" --as-of 2026-05-01 # v0.8.1: time-travel
memex when "Brian Chesky" # v0.8.1: "when did we talk about X"
memex recent --limit 5
memex list --source web
memex get web-1582ab51a7b7
memex overview # + capture streak (v0.8.1)
memex --help
memex --version
# JSON for shell pipelines
memex search "TODO" --json | jq '.results[].snippet'
DB opens read-only — safe to run while memex-sync daemon is writing. When called without arguments (memex), the binary still runs as MCP stdio server — that's the mode Claude Code, Cursor, Cline launch via their config files. CLI and MCP modes coexist in one package.