Mooncite

Mooncite proporciona a los agentes de codificación locales una recuperación acotada y respaldada por citas del historial de conversaciones autorizado de Pi, OMP, Claude Code, Codex y ChatGPT. La recuperación devuelve localizadores de evidencia deterministas; una inspección verified los compara con los bytes físicos actuales de la fuente antes de devolver una ventana de origen. Mooncite recupera el contexto previo; no decide qué significa ese contexto ni si sigue siendo autoritativo.

Instalación

Requiere Linux con procfs, Node.js 24 o superior y el comando npm. Obtener el paquete etiquetado también requiere acceso a GitHub. Mooncite falla de forma segura cuando no puede fijar las raíces de origen autorizadas mediante descriptores de archivo de Linux.

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

Opcionalmente, verifique el lanzador instalado por separado:

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

La versión etiquetada v4.0.5 es la versión estable actual y se distribuye desde GitHub en lugar del registro npm.

Para probar la versión preliminar actual sin reemplazar la etiqueta estable:

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

Una instalación nueva coloca un paquete estable en $XDG_DATA_HOME/mooncite (por defecto ~/.local/share/mooncite), construye el índice de evidencia en $XDG_STATE_HOME/mooncite (por defecto ~/.local/state/mooncite) y crea un enlace exacto del lanzador en ~/.local/bin/mooncite. Configura cada cliente compatible que puede verificar:

• Pi: extensión delgada empaquetada

• Oh My Pi (OMP): paquete enlazado con un .mcp.json empaquetado

• Codex: registro MCP stdio local

• Claude Code: registro MCP stdio local

El resultado de la instalación informa de cada registro. Utilice un cliente solo cuando su valor sea exact; los clientes no disponibles se informan y se dejan intactos. Un registro mooncite conflictivo, un comando de lanzador no relacionado o un paquete diferente en la ruta de instalación estable se rechazan en lugar de sobrescribirse.

Después de cada instalación o reinstalación, reinicie o recargue por completo cada cliente configurado antes de usar Mooncite. No se garantiza que un cliente o proceso hijo MCP ya en ejecución se recargue en caliente y puede continuar sirviendo código o estado antiguo.

Si su shell informa mooncite: command not found, el instalador no ha editado sus archivos de inicio del shell. Use la ruta exacta mostrada arriba o agregue el directorio del lanzador a PATH:

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

Pi y OMP usan sus raíces de sesión estándar. Las raíces automáticas opcionales son ~/.claude/projects, ~/.config/claude-sol/projects, ~/.codex/sessions (o $CODEX_HOME/sessions) y ~/incoming/chatgpt-share-archive. Una raíz explícita de source add anula el descubrimiento automático para ese origen. Inicie un proceso con MOONCITE_AUTO_SOURCES=0 para deshabilitar todas las raíces automáticas opcionales. ChatGPT es un origen de fuente, no un quinto registro de cliente.

Related MCP server: Claude Memory MCP

Primera recuperación

La recuperación es una herramienta MCP utilizada dentro de un cliente registrado, no un comando de shell mooncite recall. Después de reiniciar un cliente cuyo registro es exact, pegue este mensaje:

Llame a mooncite_recall con una frase distintiva de una conversación anterior. Lea su outcome, conclusive, meaning, el match candidato, las advertencias y next. Si devuelve un candidato, pase el evidence_id del mejor candidato a mooncite_inspect. Trate verified como procedencia física, no como verdad o autoridad actual. Si la recuperación es inconclusive o unavailable, siga su siguiente acción en lugar de afirmar que la evidencia está ausente.

Herramientas

Por defecto, Mooncite expone exactamente tres herramientas MCP de evidencia:

• mooncite_recall — búsqueda léxica acotada con resultados explícitos matches, weak_leads, no_match, inconclusive, invalid_scope y unavailable

• mooncite_inspect — verifica un ID o URI de evidencia contra los bytes físicos actuales y devuelve una ventana de origen acotada

• mooncite_status — informa del estado listo, degradado o no disponible, recuentos de fuentes por origen, tiempo de actualización, errores agrupados y estado de registro sin texto de transcripción

La recuperación explica la coincidencia exacta/frase/término, los términos coincidentes y faltantes, el truncamiento de extractos, la colapso de duplicados, la supresión de salida recursiva y una próxima acción concreta. Comience sin ámbito. Reduzca solo con el project exacto o el sessionId calificado por origen copiado de un candidato. La recuperación busca primero en la proyección actual y realiza una única actualización incremental acotada solo en caso de no coincidencia; mooncite rebuild sigue siendo una operación completa explícita.

Use primero la recuperación y luego inspeccione el localizador devuelto mooncite:<origin>:… o mooncite://<origin>/… antes de confiar en la evidencia. Una inspección verified significa que los bytes físicos citados y la identidad coinciden con el índice activo; no establece que la afirmación citada sea correcta o siga siendo autoritativa. Los orígenes son pi, omp, claude-code, codex y chatgpt.

Esta versión preliminar también tiene un modo de memoria aprendida separado, desactivado por defecto. mooncite memory enable escribe una aceptación estricta privada del propietario; después de reiniciar cada cliente, agrega condicionalmente mooncite_memory_recall, mooncite_memory_inspect, mooncite_memory_write y mooncite_memory_delete. Estas herramientas almacenan interpretaciones derivadas explícitas respaldadas por citas en $XDG_STATE_HOME/mooncite/learned-memory.sqlite. Nunca agregan texto aprendido a la evidencia de origen ni al índice de evidencia desechable. Use mooncite memory disable para ocultar las herramientas conservando el estado aprendido, y mooncite memory status para inspeccionar la preparación.

Operaciones comunes

mooncite status
mooncite rebuild
mooncite source list

source add registra una anulación local explícita sin copiar el historial; source remove elimina solo esa anulación, por lo que una raíz automática disponible puede volver a activarse.

disable elimina solo los registros de clientes registrados como propiedad de la instalación. uninstall también elimina el paquete estable reconocido y el enlace exacto del lanzador. Ambos conservan el historial de fuentes, las autorizaciones de fuentes, el índice de evidencia, la configuración de memoria aprendida y cualquier base de datos aprendida. Reinicie o recargue por completo los clientes afectados después de cualquiera de los dos comandos para que las herramientas cargadas previamente dejen de ejecutarse.

purge --yes elimina por separado solo el estado derivado reconocido propiedad de Mooncite, incluidos los archivos SQLite de evidencia y memoria aprendida, y rechaza entradas desconocidas. Deja intactos el historial de fuentes y ambos archivos de configuración. Mooncite no tiene un actualizador entre versiones en el lugar. Consulte operaciones para conocer los comandos de fuentes, la retención de memoria aprendida, el orden de eliminación conservador, el manejo de fallos y los cambios de versión.

Conversaciones de escritorio de ChatGPT

Las aplicaciones de escritorio de ChatGPT usan el mismo servicio de conversaciones respaldado por cuenta que ChatGPT en la web; Mooncite no extrae cachés de aplicaciones, cookies de navegador ni credenciales. Solicite la exportación de datos compatible en ChatGPT en Configuración → Controles de datos → Exportar, extráigala en ~/incoming/chatgpt-share-archive (o registre el directorio extraído con source add chatgpt) y luego ejecute mooncite rebuild. Mooncite escanea los archivos conversation.json, conversations.json y numerados conversations-N.json; cada uno puede contener un objeto de conversación o una matriz de nivel superior.

Límite de privacidad

Mooncite es local y de solo lectura con respecto a cada archivo de origen. El descubrimiento automático se limita a las raíces estándar nombradas y se puede deshabilitar para un proceso con MOONCITE_AUTO_SOURCES=0. La recuperación devuelve extractos acotados; solo una inspección verified contiene una ventana verificada de la fuente actual. El texto enviado a través de una herramienta MCP se convierte en contexto del modelo y, por lo tanto, está sujeto al manejo de datos de ese proveedor de modelos. Mooncite no sube historial, no solicita exportaciones de ChatGPT ni invoca SSH; el historial remoto debe copiarse o montarse primero en una raíz local.

Consulte arquitectura, protocolo, operaciones y seguridad.

Repositorio: https://github.com/WhenMoon-afk/claude-memory-mcp