memex

memex

iamtouchskyerMIT
129 звёзд38 форков
AI-агенты для кодинга (Claude Code, Cursor) каждый раз начинают задачу с чистого листа. Они не помнят архитектурных решений, принятых вчера, найденных багов или написанных тестов. Memex устраняет это ограничение. Агент сохраняет ключевые выводы в виде атомарных карточек знаний с двунаправленными ссылками. При следующем запуске он подгружает релевантные карточки и продолжает работу с того места, где остановился. Технически это набор Markdown-файлов в ~/.memex/cards/. Каждая карточка — это атомарная единица знания: вывод, решение или архитектурная заметка. Карточки связаны двунаправленными ссылками [[link]], и агент строит граф знаний. Никаких векторных баз данных, эмбеддингов или облачных API — только локальные файлы, которые вы можете читать и редактировать в любом текстовом редакторе. Memex универсален: он работает как MCP-сервер (10 инструментов), как плагин для Claude Code и как расширение для VS Code. Единое хранилище ~/.memex/cards/ объединяет все платформы. Карточка, созданная в Claude Code, мгновенно доступна в Cursor.
Открыть на GitHub

Установка

npx -y @touchskyer/memex

Характеристики

Общее

  • СтатусСообщество
  • Разработчикiamtouchskyer
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Сохраняет выводы и инсайты агента между сессиями в виде связанных Markdown-карточек.
  • Автоматически подгружает контекст из сохранённых карточек в начале каждой сессии.
  • Использует двунаправленные ссылки для организации знаний (Zettelkasten).
  • Добавляет 10 MCP-инструментов для управления памятью: поиск, запись, обновление, удаление.
  • Поддерживает слэш-команды в Claude Code (/recall, /retro).
  • Работает во всех популярных редакторах: VS Code, Cursor, Windsurf, Codex.
  • Обеспечивает единое хранилище — карточки, созданные в одном клиенте, доступны в другом.
  • Не требует установки серверов, баз данных или API-ключей — всё локально.
  • Разработчик может самостоятельно читать и редактировать файлы памяти.
  • Реализован на TypeScript, лицензия MIT.

Как подключить

Способ подключения зависит от вашей среды разработки.

Универсальный способ (MCP-сервер)

Установите пакет:

npm install -g @touchskyer/memex

Добавьте сервер в конфигурацию вашего MCP-клиента (Claude Desktop, Cursor и др.):

{ "mcpServers": { "memex": { "command": "npx", "args": ["-y", "@touchskyer/memex", "mcp"] } } }

Перезапустите клиент.

Для VS Code / Copilot

Установите расширение «Memex» из маркетплейса VS Code. Дополнительная настройка не требуется.

Для Claude Code

Выполните в терминале:

/plugin marketplace add iamtouchskyer/memex /plugin install memex@memex

Для других клиентов (Codex, Windsurf, Pi)

Команда установки та же (npm install -g @touchskyer/memex), а затем выполните команду для интеграции с соответствующим клиентом (например, codex mcp add memex -- memex mcp).

Примеры запросов

  • «Сохрани описание архитектуры микросервиса в память и свяжи его с карточкой технологического стека.»
  • «Вспомни, какие методы аутентификации мы обсуждали в прошлый раз.»
  • «Покажи все карточки, в которых упоминается обработка ошибок.»
  • «Задокументируй текущее решение по кэшированию и сделай обратную ссылку на карточку базы данных.»
  • «Выполни ретроспективное сохранение ключевых решений из этого чата.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Хранилище: локальная файловая система (Markdown)
  • Клиенты: Claude Code, VS Code, Cursor, Codex, Windsurf, Pi, любой MCP-клиент
  • Разработчик: iamtouchskyer

Поделиться