Mooncite

Mooncite предоставляет локальным агентам кодирования ограниченный поиск по авторизованной истории разговоров Pi, OMP, Claude Code, Codex и ChatGPT с подтверждением источников. Поиск возвращает детерминированные локаторы доказательств; проверка verified сравнивает их с текущими физическими байтами исходного кода перед возвратом окна исходного кода. Mooncite извлекает предыдущий контекст — она не решает, что этот контекст означает или остается ли он авторитетным.

Установка

Требуется Linux с procfs, Node.js 24 или новее и команда npm. Для получения помеченного пакета также требуется доступ к GitHub. Mooncite завершает работу с ошибкой, если не может закрепить авторизованные корни источников через файловые дескрипторы Linux.

npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.5 install

При желании можно отдельно проверить установленный лаунчер:

"$HOME/.local/bin/mooncite" status

Текущий стабильный релиз — v4.0.5, распространяется с GitHub, а не из реестра npm.

Чтобы попробовать текущую предварительную версию без замены стабильного тега:

npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.6-preview.1001.0 install

Чистая установка размещает стабильный пакет в $XDG_DATA_HOME/mooncite (по умолчанию ~/.local/share/mooncite), создает индекс доказательств в $XDG_STATE_HOME/mooncite (по умолчанию ~/.local/state/mooncite) и создает точную ссылку на лаунчер в ~/.local/bin/mooncite. Она настраивает каждый поддерживаемый клиент, который может проверить:

• Pi: упакованное тонкое расширение

• Oh My Pi (OMP): связанный пакет с упакованным .mcp.json

• Codex: локальная регистрация stdio MCP

• Claude Code: локальная регистрация stdio MCP

Результат установки сообщает о каждой регистрации. Используйте клиент только в том случае, если его значение exact; недоступные клиенты сообщаются и не изменяются. Конфликтующая регистрация mooncite, несвязанная команда лаунчера или другой пакет по стабильному пути установки отклоняются, а не перезаписываются.

После каждой установки или переустановки полностью перезапустите или перезагрузите каждый настроенный клиент перед использованием Mooncite. Уже запущенный клиент или дочерний процесс MCP не гарантированно перезагрузится на лету и может продолжать использовать старый код или состояние.

Если ваша оболочка сообщает mooncite: command not found, установщик не редактировал ваши файлы запуска оболочки. Используйте точный путь, указанный выше, или добавьте каталог лаунчера в PATH:

export PATH="$HOME/.local/bin:$PATH"
mooncite status

Pi и OMP используют свои стандартные корни сеансов. Дополнительные автоматические корни: ~/.claude/projects, ~/.config/claude-sol/projects, ~/.codex/sessions (или $CODEX_HOME/sessions) и ~/incoming/chatgpt-share-archive. Явный корень source add переопределяет автоматическое обнаружение для этого источника. Запустите процесс с MOONCITE_AUTO_SOURCES=0, чтобы отключить все дополнительные автоматические корни. ChatGPT — это источник происхождения, а не пятая регистрация клиента.

Related MCP server: Claude Memory MCP

Первый поиск

Поиск — это инструмент MCP, используемый внутри зарегистрированного клиента, а не команда оболочки mooncite recall. После перезапуска клиента, чья регистрация exact, вставьте этот запрос:

Вызовите mooncite_recall с одной отличительной фразой из более раннего разговора. Прочитайте его outcome, conclusive, meaning, кандидата match, предупреждения и next. Если он возвращает кандидата, передайте evidence_id лучшего кандидата в mooncite_inspect. Считайте verified физическим происхождением, а не истиной или текущим авторитетом. Если поиск inconclusive или unavailable, следуйте его следующему действию, а не утверждайте, что доказательства отсутствуют.

Инструменты

По умолчанию Mooncite предоставляет ровно три инструмента MCP для доказательств:

• mooncite_recall — ограниченный лексический поиск с явными результатами matches, weak_leads, no_match, inconclusive, invalid_scope и unavailable

• mooncite_inspect — проверка идентификатора или URI доказательства на соответствие текущим физическим байтам и возврат ограниченного окна источника

• mooncite_status — сообщает о готовности, деградации или недоступности, количестве источников по происхождению, времени обновления, сгруппированных ошибках и состоянии регистрации без текста транскрипта

Поиск объясняет точное/фразовое/терминологическое совпадение, совпадающие и отсутствующие термины, усечение выдержки, свертывание дубликатов, подавление рекурсивного вывода и конкретное следующее действие. Начните без ограничений. Сузьте только с точным project или sessionId с квалификацией источника, скопированным из кандидата. Поиск сначала ищет в текущей проекции и выполняет одно ограниченное инкрементальное обновление только при промахе; mooncite rebuild остается явной полной операцией.

Сначала используйте поиск, затем проверьте возвращенный локатор mooncite:<origin>:… или mooncite://<origin>/…, прежде чем полагаться на доказательства. Проверка verified означает, что цитируемые физические байты и идентичность соответствуют активному индексу; это не устанавливает, что цитируемое утверждение верно или все еще авторитетно. Источники: pi, omp, claude-code, codex и chatgpt.

Эта предварительная версия также имеет отдельный, по умолчанию отключенный режим изученной памяти. mooncite memory enable записывает строгий частный opt-in владельца; после перезапуска каждого клиента он условно добавляет mooncite_memory_recall, mooncite_memory_inspect, mooncite_memory_write и mooncite_memory_delete. Эти инструменты хранят явные производные интерпретации с подтверждением цитирования в $XDG_STATE_HOME/mooncite/learned-memory.sqlite. Они никогда не добавляют изученный текст в исходные доказательства или в одноразовый индекс доказательств. Используйте mooncite memory disable, чтобы скрыть инструменты, сохраняя изученное состояние, и mooncite memory status для проверки готовности.

Общие операции

mooncite status
mooncite rebuild
mooncite source list

source add записывает явное локальное переопределение без копирования истории; source remove удаляет только это переопределение, поэтому доступный автоматический корень может снова стать активным.

disable удаляет только регистрации клиентов, записанные как принадлежащие установке. uninstall также удаляет распознанный стабильный пакет и точную ссылку на лаунчер. Обе команды сохраняют историю источников, авторизации источников, индекс доказательств, конфигурацию изученной памяти и любую изученную базу данных. Полностью перезапустите или перезагрузите затронутые клиенты после любой из этих команд, чтобы ранее загруженные инструменты перестали работать.

purge --yes отдельно удаляет только распознанные производные данные, принадлежащие Mooncake, включая файлы SQLite индекса доказательств и изученной памяти, и отказывается от неизвестных записей. Он оставляет историю источников и оба файла конфигурации нетронутыми. Mooncake не имеет обновления на месте между версиями. См. operations для команд источников, хранения изученной памяти, консервативного порядка удаления, обработки сбоев и изменений версий.

Разговоры в настольном приложении ChatGPT

Настольные приложения ChatGPT используют ту же службу разговоров с поддержкой учетной записи, что и ChatGPT в Интернете; Mooncake не извлекает данные из кэшей приложений, файлов cookie браузера или учетных данных. Запросите поддерживаемый экспорт данных в ChatGPT в разделе Настройки → Управление данными → Экспорт, извлеките его в ~/incoming/chatgpt-share-archive (или зарегистрируйте извлеченный каталог с помощью source add chatgpt), затем запустите mooncite rebuild. Mooncake сканирует файлы conversation.json, conversations.json и пронумерованные файлы conversations-N.json; каждый может содержать один объект разговора или массив верхнего уровня.

Граница конфиденциальности

Mooncake является локальным и доступным только для чтения по отношению к каждому файлу источника. Автоматическое обнаружение ограничено указанными стандартными корнями и может быть отключено для процесса с помощью MOONCITE_AUTO_SOURCES=0. Поиск возвращает ограниченные выдержки; только проверка verified содержит окно, проверенное по текущему источнику. Текст, отправленный через инструмент MCP, становится контекстом модели и затем подчиняется правилам обработки данных этого поставщика модели. Mooncake не загружает историю, не запрашивает экспорт ChatGPT и не вызывает SSH; удаленная история должна быть сначала скопирована или смонтирована в локальный корень.

См. architecture, protocol, operations и security.

Репозиторий: https://github.com/WhenMoon-afk/claude-memory-mcp