nautli

Toda herramienta de memoria de IA almacena. nautli digiere.

Un solo cerebro local para todos tus agentes de IA. Claude Code, Cursor y otros clientes MCP comparten una única memoria local. Mientras duermes, un demonio de digestión fusiona duplicados, convierte las contradicciones en tarjetas de revisión y olvida la basura. La fuente de verdad son archivos de texto plano en tu disco, no el servidor de otra persona.

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

Instalación

npx nautli dashboard

El panel de control se abre solo en 127.0.0.1 y te guía paso a paso por todo el proceso:

1. Chequeo de memoria: analiza las notas que ya tienes (una bóveda de Obsidian, CLAUDE.md, archivos de memoria de agentes) y muestra una puntuación de salud con duplicados reales, contradicciones y hechos obsoletos extraídos de tus propios datos. La vista previa escanea hasta 40 notas y suele tardar unos 10 minutos. Importa lo que haya encontrado con un clic, o empieza desde cero.

2. Conecta Claude Code: registro MCP en un clic (herramientas remember / recall / briefing).

3. Instrucciones de hábito: añade un bloque a tu CLAUDE.md para que la IA use realmente su memoria.

4. Demonio de digestión nocturna: cada noche a las 3:30, los duplicados se fusionan y las contradicciones se convierten en tarjetas de revisión. Se puede eliminar por completo con un botón.

Requisitos, con sinceridad

better-sqlite3 es un módulo nativo. La mayoría de las plataformas descarga un binario precompilado; las combinaciones inusuales de plataforma y Node recurren a la compilación, que necesita python3 y un kit de herramientas (toolchain) de C++.

Qué herramientas de IA funcionan hoy

Deja que un agente de código lo instale por ti

Pega esto en Claude Code o en cualquier agente de código; todo el flujo es no interactivo:

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

Instalación global, si lo prefieres: npm i -g nautli, luego nautli dashboard. Colaboradores: git clone https://github.com/nautli/nautli.git && cd nautli && npm install && node src/cli.js dashboard.

Related MCP server: MCP Memento

Por qué otra herramienta de memoria

Una memoria que solo crece acaba convirtiéndose en un cajón de basura: tres copias de cada hecho, dos de ellas desactualizadas, y tu IA elige una al azar. La mayoría de las herramientas de memoria almacenan y recuperan. nautli trata la memoria como algo que debe digerirse:

• Digestión, no acumulación. Un demonio nocturno fusiona duplicados y resuelve lo que puede resolver con seguridad.

• Tarjetas de revisión, no ediciones silenciosas. Los juicios ambiguos nunca se aplican automáticamente. Las contradicciones se convierten en tarjetas de revisión que respondes con un clic, y tu respuesta se convierte en un hecho nuevo.

• Sin pérdida por diseño. El proceso automático nunca elimina hechos. Los hechos superados e invalidados se conservan con todo su historial, y rebuild restaura el índice a partir de tus archivos en cualquier momento. (nautli purge es la única excepción explícita e invocada por el usuario: elimina de forma permanente los hechos que indiques.)

• Hechos bitemporales. Cada hecho sabe cuándo era cierto y cuándo se registró; por eso "hemos cambiado del puerto 3000 al 4000" es historia, no un conflicto.

• Lo local, primero. Tu memoria son archivos en ~/.nautli/. Cambia de herramientas de IA, conserva tu cerebro.

Calidad medida hasta ahora

Las cifras siguientes provienen de nuestra evaluación interna: una ejecución de más de 4,000 átomos en nuestra propia base de datos, más ejecuciones de holdout en los archivos de tres evaluadores externos. El conjunto de evaluación etiquetado y el informe de metodología se publicarán en este repository; hasta entonces, trátalos como informes del autor.

• Fusiones automáticas incorrectas: ninguna observada hasta ahora en nuestras ejecuciones internas y de validad. La muestra aún es pequeña, por lo que no publicaremos la cifra bruta hasta que el benchmark público se lance con el conjunto de evaluación preregistrado (previsto en este repositorio).

• Recall (sensibilidad) de detección de contraiciones: 100 % en nuestro conjunto etiquetado

• Acciones automáticas incorrectas: 0, porque por política, todo lo ambiguo pasa a una tarjeta de revisión

• El punto débil honesto: filtrado de basura. Dígitos simples de basura en nuestros propios datos, con una muestra inicial mucho peor en las vistas externas. Filtro en tres etapas en desarrollo; se publicarán las cifras en cualquier caso

Límite de datos

• Recuerdos, registros de eventos e informes son archivos locales en ~/.nautli/. El contenido de tus notas y tus recuerdos nunca se sube a ningún sitio.

• Los seres prompt de juicio (comprobación de duplicados y contradicciones) se envían a Anthropel a través de tu propia suscripción a Claude. Esa es la única salida del texto de tus notas desde tu máquina.

• La teleportación anónima de uso (recuento de tarjetas, estadísticas de juicios, un UUID de instalación; nunca contenido de notas ni memoria) está activada por defecto y se envía al {{endpoint}} de telemetría de nnautilly. Se puede desactivar en cualquier momento: nautli telemetry off.

• El proceso automático nunca ELIMINA hechos, solo los archiva de forma suave. npx nautli rebuild reconstruye todo a partir de los archivos fuente. nautli purge es la única excepción explícita: elimina de forma permanente los hechos que nombres.

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

Portabilidad / export --verify

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

export --verify comprueba por separado el formato de archivo de exportación, los esquemas de hechos, los conteos y la suma de comprobación de hechos+eventos, luego realiza un round-trip verificado en un home temporal. El round-trip compara todas las filas de hechos lógicas (incluyendo cadenas de supervisión y procedencia), verifica los eventos reescritos en su orden lógico original y confirma que consultas representativas de recall devuelven los mismos IDs de los hechos en el mismo orden.

Esto es una comprobación de portabilidad de memoria. No es una prueba de integridad de copia de seguridad y no demuestr una eliminación en otras copias ni en el almacenamiento.

La cola de revisión pendiente (tarjetas de contradicción/revisión sin resolver) se incluye en la exportacción a partir del formato nautli-export/1 minor: 1, y se restaura al importar. Los archivos de exportación anteriores que no tienen este campo review se importan sin problema.

Registro manual de MCP:

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

Arquitectura

src/core almacenamiento, puerta de escritura, recall / src/mcp servidor stdio / src/cli.js / src/daemon par de juez, aplicar, informe, render / src/dashboard panel de control local / src/onboard configuración y puesta a punto. Especificación completa: SPEC.md.

Invariantes (las violaciones son bugs bloqueados por pruebas): los archivos del usuario son la fuente de verdad (ida y vuelta de rebuild) / no hay DELETE automático de hechos (purge es la excepción explícita e invocada por el usuario) / escrituras de una sola pasada, limpieza solo en el daemon / el núcleo funciona incluso si el daemon muere / sin promoción de inyección en el recall / en caso de duda, no hacer nada (coste asimétrico de una fusión incorrecta).

Límites conocidos

• npm 12 bloquea los scripts de instalación nativos por defecto, por lo que un npx nautli recién instalado falla hasta que el usuario aprueba el script de instalación de better-sqlite3 (npm install-scripts approve) y recompila. Medido 2026-07-24; reproducción completa y pasos de recuperación en docs/research/npm12-native-build.md. Se está estudiando una vía de instalación sin ciclo de vida.

• t_valid tiene granularidad de fecha; las contradicciones del mismo día se juzgan a partir de la hora registrada y el contexto

• El no determinismo del juez LLM se defiende de las cuatro formas: cwd de trabajo aislado, ejempios de formato, reintento de parseleído desde cero, y los lotes fallidos se convierten en no-ops

• Sin embeddings aún (solo búsqueda FTS por prefijo), planificado para v1.1

• La dirección de fusión se basba de t_valid; si un hecho más joven (subset) es más reciente que su superconjunto, el superconjunto puede replegarse. Corrección prevista mediante un campo keep en el juez