A local MCP that captures every word of your conversations with AI (Claude Code, Cowork, OpenClaw, Cursor) and selected Telegram chats on your machine. Search across everything at once. Your history survives even if Claude blocks your account.
Copy the prompt → paste into Claude Code, Cursor, Cline, Continue or Zed → AI installs everything itself.
Конкретные сценарии — копируй промпт, вставляй в свой AI-агент. Каждый показывает что memex реально даёт.
Сделай TG-export рабочего чата с клиентом (TG Desktop → Settings → Advanced → Export), кинь JSON в ~/.memex/inbox/. Потом в Claude / Cursor:
→ Агент найдёт релевантные сообщения, прочитает контекст и выдаст структурированный план. Ты перестаёшь вручную перечитывать три месяца переписки.
Маркетолог два месяца назад прислал deck про Q2 launch в Telegram, потом команда комментировала. Сейчас готовишь презентацию руководству:
→ Memex находит deck + часовое обсуждение вокруг него, агент читает PDF, выдаёт готовую basis для твоей презентации. Содержание deck'a + голос команды — слиты в один синтез.
Вчера в Claude Code обсуждал архитектуру. Сегодня открываешь Cursor:
→ Cursor через MCP читает сессию Claude Code. Контекст переходит между AI без повторных объяснений.
Решал что-то про pricing два месяца назад и не помнишь точную формулировку:
returns the original messages — not a paraphrase, the exact quote with date and source session."
data-ru="→ memex_search(\"pricing\") возвращает оригинальные сообщения — не пересказ, точную цитату с датой и из какой сессии.">
→ memex_search("pricing") возвращает оригинальные сообщения — не пересказ, точную цитату с датой и из какой сессии.
Возвращаешься к проекту после паузы — вместо копания в git log и заметках:
→ Агент собирает картину из последних сессий по этому project_path.
Любопытно где конкретная тема всплывала в твоём стеке:
→ 1 запрос → агент видит все упоминания через все инструменты и сводит в темы.
One folder. One database. Any agent can ask.
Common questions about scope, devices, and privacy.
Самый быстрый способ — на конкретных примерах. Открой HELP.md в репозитории — там 6 типовых сценариев с копи-пейст промптами (Telegram-чат → action plan, cross-AI bridge, точная цитата, возврат к проекту, поиск паттернов, анализ deck'a), полный reference по всем MCP-тулзам и troubleshooting.
Или просто скажи своему AI-агенту: «Прочитай HELP.md из репозитория memex-mvp и расскажи что я могу делать с memex». Агент сам прочитает файл и пройдётся по сценариям.
У нативной 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 |
| 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 |
| API key needed | ✗ Not needed | ✓ + billing | ✗ Not needed | bundled | bundled |
| 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 не запустится):
.nvmrc — запусти nvm use в директории проекта.
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 живёт на одной машине — 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 делает: Живёт только на твоей машине, никуда не звонит, без 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.
Сегодня: 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 — пересылаешь мысли и сообщения с телефона, индексируется автоматически на ноуте.
Да. ~/.memex/data/memex.db — обычный SQLite-файл. Три команды на старом ноуте, три на новом — вся история переезжает вместе с FTS5-индексом. Точные команды — в README → Миграция между устройствами.
Memex не зависит от твоего provider-аккаунта — читает файлы которые уже на твоём диске. Даже после бана твои Claude Code сессии в ~/.claude/projects/ остаются на месте. Memex индексирует их и отдаёт через MCP любому локально доступному AI (Llama, Qwen, или Claude через другой аккаунт). Твоя работа переживает канал доступа.
Two paths. Pick the one that fits.
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.
Do these five steps in order. Show each command before you run it. Stop and ask if anything fails or looks wrong.
1. Clone and install
- Suggest a parent directory (default: ~/Documents). Confirm with me.
- cd into that directory
- git clone https://github.com/parallelclaw/memex-mvp
- cd memex-mvp
- npm install
Verify: server.js exists; npm install completed without fatal errors.
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.
- First, get the ABSOLUTE path to the node binary — GUI apps (Cursor, Cline, Claude Desktop) on macOS often don't inherit shell PATH, so a bare "command": "node" fails with `spawn node ENOENT`. Especially true for nvm users (node lives at ~/.nvm/versions/node/<ver>/bin/node). Run:
which node
Capture that path. If it's a shim (e.g. ~/.asdf/shims/node) — also run `realpath $(which node)` to resolve to the real binary.
- MERGE this entry into mcpServers — never overwrite other servers I have:
{
"mcpServers": {
"memex": {
"command": "<absolute node path from which node>",
"args": ["<absolute path to memex-mvp/server.js>"]
}
}
}
Both paths must be absolute. Get the memex-mvp path from `pwd` inside the cloned directory.
- 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 both `command` and `args[0]` are absolute paths.
3. Turn on live auto-capture (recommended)
- From the memex-mvp directory: npx memex-sync install
- Then npx 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:
npx memex-sync scan
- This walks ~/.claude/projects/, Cowork sessions, Cursor state.vscdb, and any configured Obsidian vaults once, ingesting whatever exists.
- Optionally also: npx memex-sync backfill-projects — tags older conversations with their project_path so memex_list_projects works on them.
Verify: after scan, npx 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, asking which directory to clone into, and confirming which MCP client I'm using.
Установи 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.
Сделай эти пять шагов по порядку. Показывай каждую команду перед запуском. Останавливайся и спрашивай если что-то падает или выглядит не так.
1. Клонирование и установка
- Предложи parent-директорию (по умолчанию: ~/Documents). Подтверди со мной.
- cd в эту директорию
- git clone https://github.com/parallelclaw/memex-mvp
- cd memex-mvp
- npm install
Проверь: server.js существует; npm install прошёл без фатальных ошибок.
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 перед сохранением.
- Сначала определи АБСОЛЮТНЫЙ путь к node-бинарнику — GUI-приложения (Cursor, Cline, Claude Desktop) на macOS часто не наследуют PATH из shell'а, поэтому голое "command": "node" падает с `spawn node ENOENT`. Особенно если node поставлен через nvm (живёт в ~/.nvm/versions/node/<ver>/bin/node). Запусти:
which node
Запомни этот путь. Если это shim (например ~/.asdf/shims/node) — дополнительно выполни `realpath $(which node)` чтобы получить реальный бинарник.
- СМЕРДЖИ эту запись в mcpServers — никогда не перетирай другие серверы которые у меня есть:
{
"mcpServers": {
"memex": {
"command": "<абсолютный путь к node из which node>",
"args": ["<абсолютный путь к memex-mvp/server.js>"]
}
}
}
Оба пути должны быть абсолютными. Путь к memex-mvp получи через `pwd` внутри склонированной директории.
- Если config-файла нет — создай parent-директорию и запиши минимальный валидный файл только с memex.
Проверь: перечитай файл после сохранения; убедись что memex-запись на месте и оба пути (`command` и `args[0]`) абсолютные.
3. Включи live auto-capture (рекомендуется)
- Из директории memex-mvp: npx memex-sync install
- Потом npx memex-sync status — должен напечатать "daemon installed", "running (PID …)", "watching N sessions".
Проверь: status показывает не-нулевой PID.
4. Backfill существующей истории (рекомендуется при первой установке)
- Daemon ловит только НОВЫЕ сессии. Чтобы проиндексировать всё что уже на диске:
npx memex-sync scan
- Это один раз обходит ~/.claude/projects/, Cowork-сессии, Cursor state.vscdb, и любые сконфигурированные Obsidian-vaults, ингестируя что есть.
- Опционально также: npx memex-sync backfill-projects — простит project_path старым conversation'ам чтобы memex_list_projects работал и на них.
Проверь: после scan npx 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-клиенте я тебя запустил.
Each step shows where it happens. You only do this once.
git clone https://github.com/parallelclaw/memex-mvp
cd memex-mvp
npm install
The third command prints a lot of text — that's normal, wait until it finishes.
Still in Terminal, get two absolute paths — memex location and your node binary location:
pwd # → your-memex-path
which node # → your-node-path
Open ~/.claude/config.json and paste — replace both placeholders with the actual paths:
{
"mcpServers": {
"memex": {
"command": "your-node-path",
"args": ["your-memex-path/server.js"]
}
}
}
Why absolute node path? GUI apps (Cursor, Cline, Claude Desktop) on macOS often don't see your shell PATH, so a bare "node" fails with spawn node ENOENT — especially with nvm. Always use the path from which node. Cursor, Cline, Continue, Zed have similar config files — same JSON shape.
npx memex-sync install
Small background process — catches every new Claude Code / Cowork session within ~1.5 seconds. Install once, forget it.
npx 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.
MIT-licensed, not VC-funded. Rewind/Limitless got bought by Meta and shut down their Mac app in 2025. Local-first tools die when their owners cash out. Memex can't — there's no central owner to buy.