Neotoma

Probar con seguridad

No necesitas comprometerte con Neotoma para saber si te encaja. Instálalo junto a lo que ya uses, ingiere una porción de tu historial, ejecuta tu agente con y sin Neotoma y compara. Nada de tu configuración actual se mueve, modifica ni reemplaza.

Esta guía recorre la ruta recomendada de instalación en sombra: instalar → ingerir historial → comparar A/B → decidir. Tu sistema de memoria existente (MEMORY.md, claw.md, un servidor MCP propio, memoria de plataforma como Claude o ChatGPT) queda intacto en todo momento.

Qué significa "probar con seguridad" aquí

Neotoma escribe en una base SQLite local dentro de su propio directorio de datos. No toca tus otros archivos, la configuración del editor, las plantillas de prompts de tu agente ni cualquier otro almacén de memoria que ya uses. Si desinstalas, el único artefacto es el directorio de datos de Neotoma; todo lo demás sigue exactamente donde estaba.

  • Tus archivos de memoria existentes no se leen, bloquean ni reescriben.

  • Los datos de Neotoma viven en su propio directorio que puedes borrar, respaldar o apartar cuando quieras.

  • Tu agente decide cuándo leer o escribir en Neotoma; nada se intercepta en segundo plano.

  • Los esquemas se infieren a partir de tus datos, así que la prueba no requiere modelar nada por adelantado.

Paso 1 — Instala en modo sombra

npm install -g neotoma
NEOTOMA_DATA_DIR=~/.neotoma-shadow neotoma setup --tool cursor --yes

neotoma setup --tool <tool> --yes es la ruta más rápida cuando ya sabes con qué cliente quieres probar primero. Ejecuta el paso idempotente de init, configura MCP y aplica la guía local del agente correspondiente. Sustituye cursor por claude-code, codex u otra herramienta compatible. Si prefieres el flujo paso a paso, usa neotoma init --interactive y luego neotoma mcp config.

Si ejecutas setup con NEOTOMA_DATA_DIR, el paso de init dentro de setup escribe esa ruta en la configuración de entorno de Neotoma para que los siguientes comandos reutilicen el mismo directorio en sombra:

neotoma storage info

Todo lo guardado durante la prueba aterriza en ~/.neotoma-shadow.

Paso 2 — Inicia opcionalmente la API local

Solo lo necesitas si quieres la API HTTP local, el Inspector, flujos OAuth o una vía de transporte que dependa del servidor API. La ruta MCP local por defecto que configura setup no lo requiere.

neotoma api start

Paso 3 — Ingiere una porción de tu historial

Neotoma puede absorber los artefactos que tu agente ya produjo (transcripciones de chat, notas, exportaciones). Eso es lo que te permite hacer preguntas comparativas de inmediato, sin esperar semanas a que se acumule historial nuevo.

# Descubre archivos candidatos (escaneo solo-lectura)
neotoma discover ~/Documents ~/Desktop --limit 50

# Previsualiza una transcripción antes de la ingesta
neotoma ingest-transcript ~/Downloads/chatgpt_export.json

# Ingiere un archivo con clave de idempotencia explícita
neotoma ingest --file ~/Notas/reunion_2026_03_14.md

neotoma discover es un pase de ranking solo-lectura. No modifica ningún archivo origen. ingest-transcript previsualiza la estructura antes de cualquier escritura. ingest es el paso de escritura real y sella cada fila con procedencia para que puedas rastrear cualquier hecho almacenado al archivo origen.

Si prefieres empezar vacío y dejar que tu agente pueble Neotoma sesión a sesión, omite este paso. El paso 4 igual funciona; solo mide comportamiento hacia adelante en lugar de reconstrucción histórica.

Paso 4 — Ejecuta en paralelo

Abre dos ventanas, sesiones o espacios de trabajo. Configura uno para exponer el servidor MCP de Neotoma; configura el otro sin él. Haz las mismas preguntas en ambos.

Buenas preguntas de comparación:

  • «¿Con quién hablé por última vez sobre <proyecto>? ¿Qué acordamos?»

  • «¿Cuál es el estado actual de cada tarea que comprometí este mes?»

  • «Muéstrame la línea de tiempo de cambios de <entidad>, con fuentes.»

  • «¿Por qué decidimos <decisión>? ¿Qué entradas teníamos delante?»

El agente sin Neotoma improvisará o se negará. El agente con Neotoma debería poder citar entidades, observaciones y archivos origen concretos para cada respuesta.

Paso 5 — Decide

Cualquiera de los dos desenlaces está bien:

  • Te quedas: apunta el resto de tus clientes al servidor MCP de Neotoma y deja que tu archivo de memoria existente pase a archivo. Puedes seguir ingiriendo hacia atrás (transcripciones más antiguas, exportaciones) a tu ritmo.

  • Te marchas: detén el servidor de Neotoma, quita su entrada MCP de cada cliente y borra el directorio de datos. Tu configuración previa queda exactamente como estaba: no hay nada que revertir en tu otro almacén de memoria.

# Detén la API local (si la iniciaste)
neotoma api stop

# (Opcional) borra los datos de la prueba
rm -rf ~/.neotoma-shadow

Lo que esto no requiere

Relacionado:

guía de instalación

,

walkthrough

,

versionado y evolución de esquemas

, y

backup y restauración

.