Memnest

Memoria local-primero para agentes de codificación, con búsqueda híbrida y acceso MCP.

Documentación

memnest

Memoria local para encontrar lo que hiciste con una IA de programación y por qué decidiste hacerlo.

Memnest almacena el texto de conversaciones de pi, Claude Code y Codex en tu máquina. Las IAs conectadas pueden buscar esos registros y leer la fuente después de que una sesión termine. Conecta varios clientes al mismo servicio de Memnest para usar el mismo historial.

Cuándo usarlo

Usa el registro acumulado para preguntas como:

¿Por qué cambiamos de gestor de tareas? Encuentra la discusión detrás de esa decisión.

¿Qué enfoque de despliegue acordamos por última vez para este proyecto y por qué?

¿Qué intentamos la última vez que ocurrió este error?

La IA busca en la memoria, lee la fuente relevante y la usa para responder. Los resultados incluyen IDs de fuente para que puedas verificar la evidencia. Estos son ejemplos de solicitudes, no una demostración autónoma ni una garantía de que se encontrará una respuesta.

Para algunas reglas que deberían aplicarse cada vez, AGENTS.md o CLAUDE.md es más simple. Memnest es para un historial creciente de conversaciones y decisiones que quieras consultar cuando sea necesario.

Instalación

Hay archivos disponibles para Linux x86_64 y Arm64; no se requiere Rust. La primera escritura o búsqueda descarga un modelo de embeddings de aproximadamente 1.1 GB. El embedding puede usar alrededor de 1.9 GB de RAM.

Lee el script descargado antes de ejecutarlo. Antes de actualizar una instalación existente, haz una copia de seguridad de memory.db junto con master.key.

curl -fsSL https://raw.githubusercontent.com/Blue-B/memnest/v0.3.1/core/scripts/install.sh \
  -o /tmp/memnest-install.sh
VERSION=v0.3.1 bash /tmp/memnest-install.sh --user

La configuración inicia el servidor y el observador de conversaciones, y añade conexiones faltantes a las configuraciones compatibles de Claude Code, Codex y Cursor. Hace una copia de seguridad de la configuración existente antes de modificarla e imprime comandos de recuperación.

Conectar pi

Con el núcleo en ejecución, instala la extensión correspondiente:

pi install npm:pi-memnest@0.3.1

Si Memnest ya está registrado desde otra fuente, elimina ese registro primero para evitar cargarlo dos veces. Usa /memnest en pi para verificar la conexión. Consulta configuración de la extensión.

Otros clientes MCP se conectan a http://127.0.0.1:3111/mcp. Consulta ejemplos de conexión, otros entornos e instalación desde fuente y actualización y recuperación. macOS es solo desde fuente; la instalación y eliminación nativas no han sido validadas.

Uso

Pide a tu IA conectada que busque una conversación o decisión anterior. La recuperación automática está desactivada por defecto; puedes comenzar solicitando una búsqueda cuando la necesites. Consulta configuración de la extensión para habilitar la recuperación automática.

Los clientes que llaman a herramientas directamente usan este flujo:

memory_search(query="reason for switching task managers")
memory_get(id="<ID returned by search>")

Cinco herramientas cubren guardar, buscar, leer, corregir y eliminar. Usa memory_remember para guardar explícitamente una decisión importante. Cuando un hecho cambie, guarda su reemplazo con supersedes=<old ID> para vincularlo al registro anterior.

Cuando el host proporciona el directorio actual, las búsquedas incluyen ese espacio de trabajo y el playbook compartido. Especifica project=all para una búsqueda deliberada entre proyectos. Consulta lectura de fuentes para registros largos y entradas de conversación cercanas.

Las conversaciones anteriores a la instalación no se importan automáticamente. Selecciona los archivos originales que necesites con importación de historial.

Límites importantes

La recuperación no es verificación de la verdad. La búsqueda puede no encontrar un registro relevante. Memnest no puede determinar si una decisión antigua sigue vigente. Una pista de fuente seguida no es una relación de respuesta verificada.
La captura es selectiva. Almacena texto visible de conversación, no razonamiento, tráfico de herramientas, imágenes ni conversaciones de subagentes. No importa la memoria integrada de ChatGPT ni de Claude.
El almacenamiento es local; tu IA conectada responde. Memnest no realiza llamadas generativas de LLM. Un proveedor de IA en la nube recibe el texto recuperado que tú envías a su modelo.
Las memorias regulares no están cifradas. La redacción maneja patrones de credenciales conocidos, no todos los secretos posibles. No expongas el puerto 3111 directamente a internet.
La eliminación no es un borrado inmediato. Los registros permanecen en la papelera durante 30 días y pueden permanecer en el archivo JSONL. Consulta límites de seguridad y eliminación.

Documentación y verificaciones

Un servicio en Rust almacena registros de fuente en SQLite y busca con BM25 más embeddings multilingües locales. Los índices de búsqueda se pueden reconstruir a partir de los registros de fuente.