A single store
for all your AI and Telegram chats

Локальная память для всего что ты говоришь AI — и выбранных Telegram-чатов. Один файл на твоём ноутбуке. Любой агент (Claude, Cursor, Cline, …) читает из одной памяти.

⚡ Install in 60 seconds
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.

— or, install via AI agent —

Copy the prompt → paste into Claude Code, Cursor, Cline, Continue or Zed → AI installs everything itself.

↓ or install manually

MIT · Survives provider bans by design · No cloud · No API keys

Половина твоих решений живёт в Telegram. Теперь AI читает их вместе с тобой.

Telegram-чаты — теперь часть AI-памяти

Экспорт → memex ловит сам → AI спрашивает что импортить. 30 секунд. Privacy-first.

1
📱

Экспорт в Telegram Desktop

Открой любой чат → Export chat history → HTML или JSON. Это всё что от тебя нужно.

2
🔔

memex ловит сам

Daemon следит за ~/Downloads/Telegram Desktop/. Через ~7 секунд после экспорта — macOS-banner: «1 new chat ready to review».

3
🤖

AI спрашивает: какие импортить?

Открой Claude (или кликни banner) — первая реплика: «Вижу: Семья · Работа · Психолог. Импортировать? Психолога пропусти.»

Теперь спрашивай AI то что раньше было невозможно
🔍 Найти точную цитату из переписки 3-месячной давности
Ты

Что Аня говорила про дизайн презентации в марте?

Claude

Нашёл в чате «Конференция Q2» (Telegram, 23 марта):

Аня: «давай минималистичнее — белый фон, только тезисы. Тёмная версия для титульной»

Аня также предложила Helvetica. Ты согласился, но сказал «проверить читаемость в зале».

📋 1,800 сообщений → план действий за 8 секунд
Ты

Вытащи из рабочего чата за последний месяц: что висит на мне, что заблокировано, кто ждёт ответа.

Claude

Из чата «Работа» (1,847 сообщений, 16 апр → 16 мая):

  • На тебе (3): подписать Q2-бюджет · пингануть Игоря про контракт · ревью драфта от Ани
  • Заблокировано (1): запуск — юристы не ответили по условиям
  • Ждут (2): Саша — время встречи · Аня — комменты по слайдам

🔒 Privacy-first: ты выбираешь каждый чат сам. Психолога или банк — пропускаешь одним кликом. Block patterns (*bank*) для целых категорий. Локальный SQLite, никуда не уходит.

Что спросишь первым?

Memex use cases

Конкретные сценарии — копируй промпт, вставляй в свой AI-агент. Каждый показывает что memex реально даёт.

📋 Превратить рабочий чат из Telegram в чек-лист

Экспортируй чат с клиентом из Telegram Desktop (чат → ⋮ → Export chat history) — JSON или HTML. v0.10+ memex сам найдёт экспорт в ~/Downloads/, спросит какие чаты импортить — скажи «import family and work». Дальше в Claude / Cursor:

Прочитай через memex_search мой последний месяц переписки с клиентом X в Telegram. Сделай чек-лист действий с приоритетами и список открытых вопросов на которые надо ответить.

→ Агент найдёт релевантные сообщения, прочитает контекст и выдаст структурированный план. Ты перестаёшь вручную перечитывать три месяца переписки.

🌉 Один AI видит историю другого

Вчера в Claude Code обсуждал архитектуру. Сегодня открываешь Cursor:

Найди через memex_search что я вчера обсуждал с Claude про auth. Продолжай отсюда — не нужно объяснять заново.

→ Cursor через MCP читает сессию Claude Code. Контекст переходит между AI без повторных объяснений.

🔗 Сохранить research из Perplexity, статьи, AI-share'ы

Сделал 20 минут research'a в Perplexity. Не хочешь, чтобы он остался в одной вкладке навсегда. (v0.6+)

Сохрани https://www.perplexity.ai/share/<id> в memex (поставь теги 'research', 'competitor-analysis'). Хочу позже находить это из любого AI.

→ Агент fetch'ит страницу (для Cloudflare-блока auto-falls back на r.jina.ai — memex учит трюку), вызывает memex_store_document, хранит verbatim. Ищется из любого AI-чата. Работает для любых URL — Perplexity, блог-постов, ChatGPT/Gemini share'ов, Twitter, GitHub discussions.

4 more scenarios — project resume · deck analysis · exact-wording recall · pattern discovery

🔄 «Где я остановился в этом проекте?»

Возвращаешься к проекту после паузы — вместо копания в git log и заметках:

Возвращаюсь к проекту memex после двух недель. Через memex_list_projects и memex_recent покажи где я остановился. Что сделано, что осталось?

→ Агент собирает картину из последних сессий по этому project_path. (Примечание: Brian Chesky auto-context хук делает это сам — этот сценарий для случая когда явно спрашиваешь.)

📊 Pitch-deck из рабочего Telegram-чата + контекст обсуждения

Маркетолог два месяца назад прислал deck про Q2 launch в Telegram, потом команда комментировала. Готовишь презентацию руководству:

Через memex_search найди в моём чате с маркетологом deck про Q2 launch (около двух месяцев назад) и всё обсуждение вокруг него. Открой сам файл (путь у memex в metadata) и сведи: 1) тезисы deck'a, 2) комментарии команды, 3) открытые вопросы.

→ Memex находит deck + обсуждение вокруг него, агент читает PDF, выдаёт готовую basis для презентации.

🔍 Найти что именно ты сказал в марте

Решал что-то про pricing два месяца назад и не помнишь точную формулировку:

В марте я что-то решал про pricing. Найди дословную формулировку в моих сессиях с AI.

returns original messages — not a paraphrase, exact quote with date and source session." data-ru="→ memex_search(\"pricing\") возвращает оригинальные сообщения — точную цитату с датой и из какой сессии."> → memex_search("pricing") возвращает оригинальные сообщения — точную цитату с датой и из какой сессии.

💡 Найти паттерны во всех твоих AI-разговорах

Любопытно где тема всплывала в твоём стеке:

Через memex_search найди все упоминания Postgres в моих сессиях с AI. В каком контексте? Что я решал?

→ 1 запрос → агент видит все упоминания через все инструменты, группирует по темам.

Через полгода, когда понадобится точная цитата — она будет на месте.

memex сохраняет каждое слово.

Другие AI-memory инструменты сжимают разговоры в AI-сгенерированные summary. Точные формулировки — слова Claude'a, твои примеры кода, ход обсуждения — теряются. memex хранит дословно. Навсегда.

What claude-mem stores (AI-summarized)
title: "Multi-tenant auth strategies discussed"
subtitle: "RLS recommended over JWT"
narrative: "User asked about multi-tenant auth. Claude discussed three approaches and recommended PostgreSQL RLS."
facts: ["RLS preferred for cost", "JWKS rotation mentioned"]
concepts: ["multi-tenancy", "auth", "RLS"]

→ Через полгода: помнишь что посоветовали RLS. А точное обоснование Claude'a? Детали про JWKS-ротацию? Кодовые примеры? Потеряны.

What memex stores (verbatim transcript)
ты · 15 мар 14:32

как делать auth для multi-tenant?

Claude · 15 мар 14:32

Для 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 — хочется просто открыть и увидеть всё самому.

Открой свою память в браузере (v0.10.8+)

Одна команда — memex web --open. Локальный read-only веб-просмотрщик корпуса. 5 страниц, ~30KB клиентского бандла, те же verbatim chat-bubbles что выше.

📊

Dashboard

Статы корпуса, sources breakdown, последние 10 чатов, callout про pending Telegram — всё за один взгляд.

🔍

Conversations

Live FTS5-поиск через htmx (debounce 200мс). Фильтры-чипы по source. Кол-во hit'ов на каждый чат.

💬

Verbatim transcript

Каждое сообщение — chat-bubble'ом, то самое что не делает claude-mem (он только AI-резюмирует). Поиск внутри чата с подсветкой. Пагинация для чатов 1000+.

📬

Pending

Telegram-экспорты ждущие решения. Чекбоксы для bulk Import / Skip — тот же privacy-gate, что и в memex telegram import.

⚙️

Settings

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).

FAQ

Common questions about scope, devices, and privacy.

What do I need to install memex? Any limitations?

Жёсткие требования (без них memex не запустится):

  • Node.js 20.x – 24.x (рекомендуем 22 LTS). Поставь через nodejs.org, brew install node или nvm.
  • macOS 12+ или Linux с inotify. Windows — только через WSL.
  • Xcode Command Line Tools на macOS (xcode-select --install) — нужны для нативной сборки better-sqlite3, если для твоей Node-версии нет prebuilt binaries.
  • MCP-совместимый AI-клиент — Claude Code, Cursor, Cline, Continue, Zed. Без него memex строит индекс, но обращаться к нему будет некому.

Известные ограничения:

  • Web-only AI (ChatGPT в браузере, Claude.ai web) — эти сессии живут на серверах вендора, на твоём диске их нет.
  • Мобильные AI-приложения (ChatGPT iOS, Claude Android) — phone-data не пишется на твой компьютер.
  • Сессии на VPS / в облаке — memex читает только локальную файловую систему.
  • Auto-capture daemon на Linuxnpx memex-sync install работает только на macOS (LaunchAgent). На Linux запускай npx memex-sync в foreground или сделай свой systemd unit.
  • Telegram mobile export — мобильный TG не умеет экспортировать чаты. JSON для memex'a делает только Telegram Desktop.

Положительное «ограничение»: Internet не нужен после установки. Никаких phone-home, никаких API-ключей, никаких облачных зависимостей. Это feature, не bug.

What about privacy and encryption?

Что 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.

I just installed memex — what do I do now?

Самый быстрый способ — на конкретных примерах. Открой HELP.md в репозитории — там 6 типовых сценариев с копи-пейст промптами (Telegram-чат → action plan, cross-AI bridge, точная цитата, возврат к проекту, поиск паттернов, анализ deck'a), полный reference по всем MCP-тулзам и troubleshooting.

Или просто скажи своему AI-агенту: «Прочитай HELP.md из репозитория memex-mvp и расскажи что я могу делать с memex». Агент сам прочитает файл и пройдётся по сценариям.

What if my Claude / ChatGPT account gets banned?

Memex не зависит от твоего provider-аккаунта — читает файлы которые уже на твоём диске. Даже после бана твои Claude Code сессии в ~/.claude/projects/ остаются на месте. Memex индексирует их и отдаёт через MCP любому локально доступному AI (Llama, Qwen, или Claude через другой аккаунт). Твоя работа переживает канал доступа.

How is memex different from native Claude / ChatGPT memory?

У нативной AI-памяти пять структурных дыр. Memex закрывает все пять:

  • Жёстко изолированные per-project silos (Claude Memory закрывает границы намертво) → memex project-aware, не siloed: опциональный project-фильтр в поиске, default — широкий. Граница на каждый запрос — твой выбор.
  • Между продуктами Anthropic нет мостов (Web Claude не видит Code; Code не видит Cowork) → все продукты Anthropic + субагенты Cowork в одном поисковом индексе.
  • Cross-AI памяти не существует by design (ChatGPT, Cursor, Cline, Zed, Telegram-боты — каждый держит свой silo) → любой MCP-клиент читает одну и ту же память через 11 стандартных тулзов.
  • Привязка к одной машине (история Claude Code на конкретном ноуте) → memex — обычный SQLite-файл, синк через iCloud / Syncthing / rsync на твой вкус.
  • Аккаунт умирает — память умирает (Anthropic блокирует без предупреждения; country policy режет RU/CN/IR/KP) → SQLite-файл на твоём ноуте не зависит от провайдера. Твоё by architecture, не по policy.

Источники: anthropics/claude-code #36561, #39195, #25739; HN #47853021 (тред про апрельские баны 2026).

How does memex compare to Mem0 / claude-mem / Supermemory?

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

When to choose what:

  • Mem0 — если строишь AI-агента для своих юзеров и нужна memory infrastructure
  • claude-mem — если живёшь в Claude Code, нужна action-level observability (какой tool, какие файлы), и тебе ок: AI-сжатые observations (сырые ответы Claude'a выбрасываются), LLM-вызов на каждый tool-use (Claude/Gemini/OpenRouter), и нет offline-режима
  • ChatGPT Memory / Anthropic Memory — если используешь только одного vendor'a и доверяешь облаку
  • memex — если ты в пересечении: несколько AI-инструментов, не хочешь облако, не хочешь подписку, хочешь чтобы архив выжил при любом сценарии
Moving to a new laptop — does memex come with me?

Да. ~/.memex/data/memex.db — обычный SQLite-файл. Три команды на старом ноуте, три на новом — вся история переезжает вместе с FTS5-индексом. Точные команды — в README → Миграция между устройствами.

Across multiple devices — does memex work?

Memex живёт на одной машине — daemon ловит локальные файлы, SQLite строится локально. Три паттерна для multi-device сегодня:

  • Синк SQLite-файла. ~/.memex/data/memex.db — обычный файл, реплицируй через iCloud / Syncthing / rsync. Daemon пишет на основной машине, остальные читают через свой локальный memex MCP. Один writer, много readers.
  • Memex на каждом устройстве независимо. Установи отдельно на каждый ноут. Нет синка, нет конфликтов — но память не унифицирована.
  • Mobile через Telegram-бот (в roadmap'е, код написан). Пересылаешь сообщения в @memex_bot — бот пишет JSON в ~/.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.

What about phone / web AI?

Сегодня: 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 — пересылаешь мысли и сообщения с телефона, индексируется автоматически на ноуте.

How does memex work under the hood?

Одна папка под каждый источник. Одна SQLite-база. Любой MCP-совместимый агент может её спрашивать. Диаграмма ниже показывает весь pipeline — от файловых watchers до MCP-tool-вызовов.

~/Downloads/Telegram Desktop/ ← v0.10+ daemon auto-stages exports ~/.claude/projects/ ← Claude Code sessions ~/Library/.../local-agent-mode ← Cowork sessions (incl. subagents) ~/.memex/inbox/ ← legacy: drop result.json manually memex-sync daemon · FSEvents · ~1.5s debounce ~/.memex/pending/ ← v0.10+ TG exports staged here for per-chat consent ~/.memex/staging/ ← atomic tmp writes chokidar inbox watcher parser JSONL / state.vscdb / Obsidian / Telegram JSON+HTML SQLite + FTS5 ~/.memex/data/memex.db · UNIQUE(msg_id) dedup MCP server stdio JSON-RPC · 18 tools · proactive instructions any client: • Claude Code → ~/.claude/config.json · + SessionStart hook for Brian Chesky moment • Cursor → ~/.cursor/mcp.json • Cline · Continue · Zed · ... your agent calls memex_overview() at session start, then memex_search() on every topic the user references — no prompting needed

Install

Быстрее всего — curl одной строкой в самом верху страницы. Или — пусть AI-агент поставит сам. Другие пути (вручную, skill, CLI-режим) — ниже.

🤖 Easiest

Let your AI install memex for you

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.

Then paste into your AI agent's chat.
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).
Other install paths — manual · AI skill · auto-context · terminal-only mode
— or do it yourself —

Manual install — 4 steps, ~5 minutes

Each step shows where it happens. You only do this once.

📟 Terminal

1. Install memex from npm

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.

📝 Text editor

2. Tell Claude Code where memex lives

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.

📟 Terminal

3. Turn on auto-capture

memex-sync install

Small background process — catches every new Claude Code / Cowork session within ~1.5 seconds. Install once, forget it.

📟 Terminal

4. Verify

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.

— or as an AI skill —

Install via skill — one line, run forever

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.

📟 Terminal

Fetch the skill

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).

💬 In your AI

Invoke it

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.

— and Claude already knows what you were doing —

Auto-context (v0.8+) — the magic moment

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.

📟 Terminal

How it gets installed

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.

💬 In Claude Code

What you experience

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.

— or query directly from the terminal —

Terminal CLI (v0.7+) — when MCP isn't available

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.

📟 Terminal

Try these commands

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.

Через год ты скажешь себе спасибо.

Install → GitHub ★