memo
Ваш агент кода начинает каждый сеанс с амнезией. memo исправляет это — 100% на вашем собственном устройстве.
Постоянная, searchable память для Claude Code, Codex, Cursor, Cline, Devin и OpenCode. Нет облака, нет ключей API, нет Ollama, нет векторной БД для запуска. И она расходует меньше токенов, а не больше.
Install
curl -fsSL https://raw.githubusercontent.com/jagoff/memo/v4.9.0/install.sh | bash
Предпочитаете пакетный менеджер? uv tool install mlx-memo · pipx install mlx-memo · brew tap jagoff/memo && brew install mlx-memo
Затем:
memo doctor # self-check
memo save 'we use Postgres, not Mongo' # save a decision
memo search 'what database did we pick?' # search by meaning
Вот и все. Ваши агенты подключаются к MCP автоматически — установщик соединяет каждого найденного клиента.
Установка на другом Mac или передача настройки агенту? Новый Mac:
curl -fsSL https://raw.githubusercontent.com/jagoff/memo/v4.9.0/install.sh | bash
memo sync bootstrap git@github.com:yourname/memo-sync.git
Настройка под управлением агента:
curl -fsSL https://raw.githubusercontent.com/jagoff/memo/v4.9.0/install.sh | bash
memo doctor --strict-runtime
На Linux или просто хотите сначала посмотреть?
docker run --rm ghcr.io/jagoff/memo:latest memo doctor
Why this saves you money
Большинство серверов памяти добавляют контекст. memo создан так, чтобы его удалять.
| Профиль | Инструменты | Токены схемы |
|---|---|---|
| агент (по умолчанию) | 41 | ~4.1k |
| core / slim | 58 | ~5.3k |
| full / default | 162 | ~18.1k |
Поверхность по умолчанию MCP — это 41 инструмент, а не 162: примерно на 75% меньше схем инструментов. Она выставляет 41 инструмент / ~4.1k токенов схемы против 162 инструментов / ~18.1k токенов на полноформатной поверхности — накладные затраты за каждый сеанс, на каждом клиенте.
Ambient recall внедряет одно релевантное воспоминание перед ответом модели. Встроенная интеграция Claude Code ограничивает такое внедрение примерно до 160 токенов. memo roi считывает реальные основы и повторно запрашивает леджеры, затем оценивает накопленную экономию с раскрытыми значениями по умолчанию (350 токенов за заземленное воспоминание и 900 за избегаемый повторный запрос).
memo roi # value from grounded recalls and avoided re-asks
memo tokens # usage-savings ledger
Three things nothing else does
🕰️ Time-machine — запрос ваших знаний таким, как они были
memo as-of ask "what was the deploy strategy?" --date 2026-02-01
memo diff --from 2026-01-01 --to 2026-03-01
Полная историческая реконструкция через обратный прогон history.db. Полезно, когда нужно понять почему прошлый вы принял решение, а не только что было решено.
⚡ Contradiction radar — память, которая замечает, когда вы меняете мнение
memo contradict scan # find conflicting facts corpus-wide
memo contradict triage # resolve: fuse / newer-wins / dismiss
Измените решение — memo пометит устаревшую версию, чтобы агент прекратил возвращать то, что вы уже отвергли.
🔮 Dream — он оптимизируется сам, пока вы спите
memo dream run
7-фазный ночной конвейер: inventory → mine signals → resolve conflicts → prune stale → synthesize cross-cluster insights → optimize → pre-warm the top-100 query embeddings so tomorrow's recall stays under 200 ms. Каждый прогон записывает квитанцию для аудита. Никаких вмешательств.
How it works
Hybrid retrieval. Одна векторная ветвь (MLX на Apple Silicon, sentence-transformers на CPU) и вторая — BM25 (FTS5, диакритика-фолдинг для Spanish) работают параллельно, объединяются через Reciprocal Rank Fusion, затем проходят через опциональный MLX cross-encoder rerank.
Markdown is the source of truth. Каждая память — обычный .md файл, который можно читать, grep-ить и версионно хранить. SQLite — производная индексная структура, которая может быть перестроена из файлов в любой момент — ручное редактирование в Obsidian и ваше редактирование победит на следующей memo reindex. Ничто не зафиксировано в базе данных, которую нельзя открыть.
Prompts and memories stay on your machine. Embender, reranker и LLM работают внутри процесса. Телеметрия отключена. Память travels только если вы укажете memo sync на git-удалённый репозиторий, который вы владеете. Обычный запуск полностью офлайн; проверки удалённых обновлений и автообновления требуют явного согласия. → Политика конфиденциальности и сетевых подключений
Также в комплекте: кросс-агентная memo resume (возобновление любой сессии у любого агента), кросс-Mac git-синхронизaция, граф знаний с опциональными связями codegraph, защищённое хранение секретов, OCR и аудиоввод, наборы доказательств, обучение на основании результатов, подписанная федерация и локальный чат-интерфейс поверх вашей памяти (memo chat serve). → Полное руководство по функциям MEMO
How it compares
Проверено в июле 2026 года по документации каждого проекта. Принципы и замечания приветствуются — откройте issue и я исправлю таблицу.
| memo | mem0 | letta | cognee | basic-memory | cipher | |
|---|---|---|---|---|---|---|
| 100% локально, без облачного API | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ | ⚠️ |
| Машина времени (перемотка к любой дате) | ✅ | ❌ | ⚠️ | ❌ | ⚠️ | ⚠️ |
| Детекция противоречий + разрешение | ✅ | ⚠️ | ⚠️ | ❌ | ❌ | ❌ |
| Автономное ночное обслуживание | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Токено-экономика MCP профилей | ✅ | ❌ | ❌ | ⚠️ | ✅ | ❌ |
| Markdown / Obsidian как источник истины | ✅ | ❌ | ⚠️ | ❌ | ✅ | ❌ |
✅ — первоклассно, ⚠️ — частично, конфигурационно зависит, или дополнение, ❌ — отсутствует
Ближайшие конкуренты — это basic-memory (локальный первый подход + Obsidian + MCP — та же концепция) и cipher (память для кодирующих агентов).
Requirements
| Поддержка | |
|---|---|
| macOS, Apple Silicon (M1–M4) | Полностью — MLX embedder + reranker + ask/synthesize/dream |
| Linux / Ubuntu | Отдельное CPU- backend — поиск, воспоминания, сохранение. pipx install "mlx-memo[cpu]" · docs/ubuntu.md |
| Intel Mac | Не поддерживается — текущие релизы PyTorch не поставляют wheels Python 3.13 для этой платформы |
| Docker | Кросс-платформенный CPU-backend · docs/docker.md |
Python ≥ 3.13 (инсталлятор устанавливает через uv, если он отсутствует). Первый запуск загружает ~8 ГБ моделей, 5–15 мин. Опционально: хранилище Obsidian — без него memo использует ~/Documents/memo/.
Docs
| Подробности установки, параметры установщика, миграция на Mac | reference.md › Install |
| Per-client MCP настройка (Claude Desktop, Cursor, Cline, Continue) | reference.md › MCP setup |
| Ambient recall, capture, and tuning | reference.md › Ambient memory |
| Полное руководство по CLI (142 команды) + memo tui | reference.md › CLI |
| Все MEMO_* флаги и профили моделей | reference.md › Configuration |
| Архитектура и заметки по дизайну | reference.md › Design |
| Политика конфиденциальности и сетевых подключений | PRIVACY.md |
Все 142 верхнеуровневые команды CLI
Полный реестр команд (держится здесь, чтобы CI отслеживал расхождения между CLI и документацией)
Core: save search ask get edit rename delete list
Recall & Hooks: recall recall-hook context briefing continuity prewarm capture-tick capture-stop interject ask-gaps guard digest
Session & History: history as-of diff record-history session chat-session resume reflect mine-history episodes chronicle
Maintenance: reindex maintain review dream consolidate synthesize dedupe retier contradict coordinate terminal invalidate temporal compress-context ops
Analysis & Quality: health stats doctor journey-check lint drift analytics eval roi tokens token-savings usefulness gaps outcome profile confidence graduation hype definitive evidence
Knowledge Graph: graph entities entity extract-entities links version related
Advanced Search: embed rerank contextual retrieve context-pack chat chat-ask repo
Import / Export / Sync: import export backup restore sync ingest federation
Visualization: tui dashboard map logs hook-log
Setup & Config: init setup config install-mcp install-watcher uninstall-watcher install-slash install-statusline install-recall-hook install-shell-wrapper install-shims startup-banner migrate migrate-vault migrate-independence update upgrade self-update watch release onboard
Daemons: recall-daemon ingest-daemon maint-daemon embed-daemon idle-daemon
Other: backend-native collaborative events feedback query mandate drift sleep-cycle operational ocr-image provenance secret verbatim mcp-command codex-badge debug-recall http-api mine-git token-gate fix undo code-facts code-nudge code-health
Contributing
git clone https://github.com/jagoff/memo && cd memo
uv pip install -e '.[dev]'
Issues и PR приветствуются — смотрите CONTRIBUTING.md. Если memo полезен, звезда ⭐ действительно помогает другим найти его.
Лицензия MIT. Основано на Apple MLX, sqlite-vec и codegraph.