Mnemon CLI
Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны
- 672 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Установка меняет настройки агента: кладет скилл, руководство и хуки в папки вроде `.claude/`, `.codex/` и `.cursor/`
- Все записи копятся в локальной базе `~/.mnemon` и возвращаются в контекст следующих сессий, поэтому секреты в память лучше не писать
- Для векторного поиска текст записей уходит на выбранный сервер эмбеддингов, а команда `mnemon web` поднимает локальный сайт на порту 8484
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mnemonОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка меняет настройки агента: кладет скилл, руководство и хуки в папки вроде `.claude/`, `.codex/` и `.cursor/`
- Все записи копятся в локальной базе `~/.mnemon` и возвращаются в контекст следующих сессий, поэтому секреты в память лучше не писать
- Для векторного поиска текст записей уходит на выбранный сервер эмбеддингов, а команда `mnemon web` поднимает локальный сайт на порту 8484
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент забывает все между сессиями: решения теряются при сжатии контекста, а ранние детали длинного диалога вытесняются. Mnemon хранит такие знания в локальной базе `~/.mnemon` и возвращает их, когда они нужны. Это один исполняемый файл на Go. Он занимается вычислениями: хранит записи, строит граф, ищет и забывает устаревшее. Что запомнить, как связать записи и когда забыть, решает сам агент, поэтому отдельная модель внутри не нужна. Агент работает с тремя операциями: `remember` записывает факт, `link` связывает записи, `recall` ищет с учетом намерения запроса. Записи лежат в четырех графах: по времени, по сущностям, по причинам и по смыслу. Поиск идет по графу, а векторный поиск через Ollama или совместимый с OpenAI сервер включается по желанию. Повторы Mnemon пропускает, важность записей со временем снижается, а редко нужные удаляются при превышении лимита в 1000 записей. Команда `mnemon setup` настраивает выбранного агента: кладет скилл `SKILL.md`, общее руководство `guide.md` и хуки начала сессии, ввода запроса и остановки. Хуки лишь напоминают агенту, что можно вспомнить прошлое или записать новое, а команды запускает сам агент. Отдельно `mnemon web` открывает локальный сайт на `127.0.0.1:8484` с библиотекой памяти, страницами записей и графом связей.
Для кого. Разработчикам, которые каждый день работают с Claude Code, Codex, Cursor или OpenCode и устали повторять агенту одни и те же решения и договоренности по проекту.
Подходит, если
- Агент в новой сессии снова спрашивает, какой фреймворк вы выбрали и почему отказались от другого
- Одни и те же знания нужны сразу в Claude Code, Codex и Cursor: у них общая база `~/.mnemon`
- Память надо разделить по проектам: `mnemon store create work` создает отдельное хранилище, а переменная MNEMON_STORE выбирает его для процесса
- Нужен обзор накопленного: `mnemon web` показывает граф записей и историю операций в браузере
- Требуется аудит работы памяти без раскрытия содержимого: Mnemon экспортирует хешированные квитанции операций без текстов записей и запросов
Не подходит, если
- Нужна память на сервере для целой команды: Mnemon хранит данные в локальной базе SQLite на вашей машине
- Агент вообще не поддерживает скиллы, правила и хуки: интеграцию нечем подключить
- Достаточно файла с правилами вроде CLAUDE.md: для небольшого набора устойчивых договоренностей отдельная память избыточна
- Нужна гарантированная запись без участия агента: что записывать и когда искать, решает сам агент
Пример запроса к агенту
Запомни, что в этом проекте мы выбрали PostgreSQL вместо MongoDB из-за транзакций, и свяжи это решение с записью про схему заказовОграничения
Для установки через npm нужен Node.js 22 или новее, но сам движок остается одним нативным бинарником на Go, а Node.js работает только как пусковой слой. На Windows доступны основные команды памяти, а режим Agency там не поддерживается.
В Claude Code хуки срабатывают в четырех точках: Prime показывает скилл и руководство, Remind напоминает про поиск по памяти, Nudge про запись, Compact сохраняет нужное перед сжатием контекста. В Codex событий три, без сжатия контекста.
Векторный поиск требует отдельного сервера эмбеддингов: Ollama по адресу `http://localhost:11434` с моделью nomic-embed-text или совместимого с OpenAI, например oMLX или Voyage AI с ключом. Без него работает поиск по графу. Отдельная команда `mnemon agency` в предварительной версии работает с агентом Pi.
Как отключить. Команда `mnemon setup --eject` снимает интеграцию с агентов: убирает скиллы, хуки и руководство. Сами записи остаются в `~/.mnemon`: удалите эту папку вручную, если память больше не нужна. Для npm-установки программу снимает `npm uninstall --global @mnemon-dev/mnemon`.
Частые вопросы
Как поставить Mnemon в Claude Code?
Выполните `npm install --global @mnemon-dev/mnemon`, затем `mnemon setup`. Команда сама находит Claude Code и в диалоге ставит скилл, хуки и руководство. По умолчанию установка локальная, в папку `.claude/` проекта, а флаг `--global` кладет все в `~/.claude/` для всех проектов. После этого откройте новую сессию.
Нужен ли ключ API для Mnemon?
Нет. Движок работает без внутренней модели и без ключей: запись и поиск по графу не обращаются к внешним сервисам. Ключ нужен только если вы подключите векторный поиск через хостинговый сервер эмбеддингов вроде Voyage AI, и тогда он передается в MNEMON_EMBED_API_KEY.
Делят ли разные сессии одну память?
Да. По умолчанию все сессии используют хранилище default, и решение, записанное в одной сессии, доступно во всех следующих. Для изоляции создайте именованное хранилище командой `mnemon store create work`, выберите его через `mnemon store set work` или передайте процессу переменную MNEMON_STORE=work.
Чем Mnemon отличается от встроенной памяти Claude Code?
Встроенная память читает файл в начале сессии. Mnemon хранит записи в четырех графах (время, сущности, причины, смысл), ищет по намерению запроса, снижает вес устаревшего и работает одновременно с несколькими агентами. Руководством по поведению служит редактируемый файл `~/.mnemon/prompt/guide.md`.
Сколько записей хранит Mnemon?
По умолчанию до 1000 активных. Лимит задает переменная MNEMON_MAX_INSIGHTS, значение 0 отключает автоматическую очистку. Запись младше 24 часов (настройка MNEMON_AUTO_PRUNE_MIN_AGE) не удаляется. Каждое автоматическое удаление помечено в журнале операций и называется по идентификатору в поле auto_pruned_ids.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыДолговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Долговременная память для агентов: собирает знания из истории сессий и возвращает их в новых задачах, единый стор между Claude Code, Codex, Cursor и другими
Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Mnemon (эта запись) | нет | 672 | ||
| MegaMemory | нет | не нужна | 732 | MCP-сервер, который ведет граф понятий и архитектуры проекта внутри репозитория |
| Basic Memory | нет | не нужна | 4 403 | хранит память агента в Markdown-файлах и работает через MCP |
Коротко о README
README объясняет проблему забывчивости агентов и сравнивает четыре подхода к памяти: модель внутри конвейера, файл при старте, MCP-сервер и внешний наблюдатель над отдельной программой. Дальше идут установка через npm, Homebrew и go install, отдельная команда настройки для каждого поддерживаемого агента, схема четырех фаз хуков, список возможностей и видение единой памяти для всех локальных агентов. В конце собраны ответы на частые вопросы, таблицы переменных окружения и команды разработки.