nautli

Каждый AI-инструмент памяти хранит. nautli переваривает.

Один локальный мозг для всех ваших AI-агентов. Claude Code, Cursor и другие MCP-клиенты используют одну общую локальную память. Пока вы спите, демон переваривания объединяет дубликаты, превращает противоречия в карточки для проверки и забывает мусор. Источник истины — обычные файлы на вашем диске, а не чей-то сервер.

You, in Claude Code:     "Remember: our API runs on port 4000."
You, in Cursor, later:   "What port does our API use?"
Cursor:                  4000  (recalled from the same local brain)

한국어 문서: README.ko.md

Установка

npx nautli dashboard

Панель управления открывается только на 127.0.0.1 и проведёт вас по всем шагам:

1. Проверка памяти: сканирует уже имеющиеся у вас заметки (хранилище Obsidian, CLAUDE.md, файлы памяти агентов) и показывает оценку здоровья с реальными дубликатами, противоречиями и устаревшими фактами из ваших данных. Предпросмотр сканирует до 40 заметок и обычно занимает около 10 минут. Импортируйте найденное в один клик или начните с чистого листа.

2. Подключение Claude Code: регистрация MCP в один клик (инструменты remember / recall / briefing).

3. Инструкции по привычкам: добавляет один блок в ваш CLAUDE.md, чтобы ИИ действительно использовал свою память.

4. Ночной демон переваривания: каждую ночь в 3:30 дубликаты объединяются, а противоречия превращаются в карточки для проверки. Полностью удаляется одной кнопкой.

Требования, честно

better-sqlite3 — это нативный модуль. На большинстве платформ загружается готовая сборка; нестандартные комбинации платформ и Node откатываются к компиляции, для которой нужны python3 и набор инструментов C++.

Какие AI-инструменты работают сегодня

Пусть кодирующий агент установит это за вас

Вставьте это в Claude Code или любого кодирующего агента; весь процесс неинтерактивный:

npx nautli setup --yes    # storage + MCP registration + instructions + nightly daemon + one digest run
npx nautli doctor         # verify the install

Глобальная установка, если предпочитаете: npm i -g nautli, затем nautli dashboard. Контрибьюторам: git clone https://github.com/nautli/nautli.git && cd nautli && npm install && node src/cli.js dashboard.

Related MCP server: MCP Memento

Зачем ещё один инструмент памяти

Память, которая только растёт, превращается в ящик с хламом: три копии каждого факта, две из которых устарели, и ваш ИИ выбирает случайную. Большинство инструментов памяти хранят и извлекают. nautli относится к памяти как к тому, что нужно переваривать:

• Переваривание, а не накопление. Ночной демон объединяет дубликаты и безопасно разрешает то, что может.

• Карточки для проверки, а не тихие правки. Неоднозначные суждения никогда не применяются автоматически. Противоречия превращаются в утренние карточки, на которые вы отвечаете в один клик, и ваш ответ становится новым фактом.

• Без потерь по своей конструкции. Автоматический конвейер никогда не удаляет факты. Заменённые и устаревшие факты архивируются с полной историей, а rebuild в любой момент восстанавливает индекс из ваших файлов. (nautli purge — единственное явное исключение, инициируемое пользователем: он навсегда удаляет указанные вами факты.)

• Битемпоральные факты. Каждый факт знает, когда он был истинным и когда был записан, поэтому «мы переехали с порта 3000 на 4000» — это история, а не конфликт.

• Локальность прежде всего. Ваша память — это файлы в ~/.nautli/. Меняйте AI-инструменты, сохраняя свой мозг.

Измеренное качество на данный момент

Цифры ниже взяты из нашей внутренней оценки: прогон на 4000+ атомов на нашем собственном хранилище плюс контрольные прогоны на хранилищах трёх внешних тестировщиков. Размеченный набор для оценки и описание методологии будут опубликованы в этом репозитории; до тех пор считайте эти цифры заявленными авторами.

• Неверных автозамен: на данный момент не наблюдалось ни в наших внутренних, ни в контрольных прогонах. Выборка всё ещё мала, поэтому мы не публикуем сырое число, пока публичный бенчмарк не выйдет с предварительно зарегистрированным набором для оценки (планируется в этом репозитории).

• Полнота обнаружения противоречий: 100% на нашем размеченном наборе

• Неверных автоматически применённых действий: 0, потому что всё неоднозначное по политике уходит в карточку для проверки

• Честное слабое место: фильтрация мусора. Одноразрядный процент мусора на наших данных, гораздо хуже на внешних хранилищах на ранних тестах. Ведётся работа над трёхступенчатым фильтром, и цифры будут опубликованы в любом случае

Границы данных

• Воспоминания, журналы событий и отчёты — это локальные файлы в ~/.nautli/. Содержимое ваших заметок и памяти никогда никуда не загружается.

• Промпты для суждений (проверки дубликатов и противоречий) отправляются через вашу собственную подписку Claude в Anthropic. Это единственное место, где текст заметок покидает вашу машину.

• Анонимная телеметрия использования (количество карточек, статистика суждений/маршрутизации, установочный UUID — никогда не содержимое заметок или памяти) включена по умолчанию и отправляется на конечную точку телеметрии nautli. Отключите в любой момент: nautli telemetry off.

• Автоматический конвейер никогда не УДАЛЯЕТ факты, только мягко архивирует их. npx nautli rebuild восстанавливает всё из исходных файлов. nautli purge — единственное явное исключение: он навсегда удаляет указанные вами факты.

CLI

npx nautli init                                              # create ~/.nautli
npx nautli remember "our API port is 4000" --scope project:myapp
npx nautli recall "port" --scope project:myapp
npx nautli daemon-run                                        # run one digestion manually
npx nautli rebuild                                           # rebuild the index from source files

Переносимость / export --verify

nautli export --verify --out nautli-memory.json
nautli import nautli-memory.json --home /path/to/empty/nautli-home

export --verify отдельно проверяет формат файла экспорта, схемы фактов, количество и контрольную сумму фактов+событий, а затем выполняет проверенный цикл в временном домашнем каталоге. Цикл сравнивает каждую логическую строку факта (включая цепочки замен и происхождение), проверяет переписанные события в их исходном логическом порядке и подтверждает, что репрезентативные поисковые запросы возвращают те же идентификаторы фактов в том же порядке.

Это проверка переносимости памяти. Это не доказательство целостности резервной копии и не доказывает удаление из других копий или хранилищ.

Очередь ожидающих проверки (нерешённые карточки противоречий/проверки) включается в экспорт, начиная с формата nautli-export/1 minor: 1, и восстанавливается при импорте. Более старые файлы экспорта, созданные до этого (без поля review), по-прежнему импортируются нормально.

Ручная регистрация MCP:

claude mcp add -s user nautli -- npx nautli mcp

Архитектура

src/core хранилище, шлюз записи, recall / src/mcp stdio-сервер / src/cli.js / src/daemon пара, судья, применение, отчёт, рендеринг / src/dashboard локальная панель управления / src/onboard настройка и проверка. Полная спецификация: SPEC.md.

Инварианты (нарушения — это баги, закреплённые тестами): пользовательские файлы — источник истины (цикл пересборки) / нет автоматического DELETE фактов (purge — явное исключение, инициируемое пользователем) / однопроходная запись, очистка только в демоне / ядро работает, даже если демон умирает / никакой инъекции продвижения в recall / при сомнениях — no-op (асимметричная стоимость неверного слияния).

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

• npm 12 по умолчанию блокирует нативные установочные скрипты, поэтому свежий npx nautli завершится ошибкой, пока пользователь не одобрит установочный скрипт better-sqlite3 (npm install-scripts approve) и не пересоберёт. Измерено 2026-07-24; полное воспроизведение и шаги по восстановлению в docs/research/npm12-native-build.md. Рассматривается путь установки без жизненного цикла.

• t_valid имеет гранулярность до дня; однодневные противоречия оцениваются по времени записи и контексту

• Недетерминизм LLM-судьи защищён четырьмя способами: изолированный cwd, примеры форматов, повтор с нулевым разбором, неудачные пакеты становятся no-op

• Эмбеддингов пока нет (только префиксный поиск FTS), планируется в v1.1

• Направление слияния основано на t_valid; если подчинённый факт новее своего родительского, родительский может быть свёрнут. Планируется исправление через поле keep судьи