Revisé el sitio [Neotoma](https://neotoma.io). El antiguo muro de texto de una sola página ahora es una presentación visual respaldada por [documentación completa](https://neotoma.io/docs), guías de integración de herramientas específicas y [inmersiones profundas en arquitectura](https://neotoma.io/architecture). La mayor parte de lo que cambió se remonta a algo que un evaluador dijo o en lo que se quedó atascado durante la versión del desarrollador.

![Captura de pantalla: héroe de la página de inicio de Neotoma: propuesta de valor y sesión de agente sin capa de estado](/images/posts/neotoma-site-overhaul-home-hero.png "captura de pantalla")

## Lo que me dijeron los comentarios

Desde que anuncié el [lanzamiento para desarrolladores](/posts/neotoma-developer-release), he recopilado comentarios de aproximadamente una docena de evaluadores a través de llamadas, chat, correo electrónico y grabaciones de pantalla. El sentimiento ha sido alentador. Una persona lo llamó "un problema muy relevante" y señaló que "la mayoría de la gente está lanzando el suyo en este momento". Otro dijo que parece un problema que vale la pena resolver. Alguien más simplemente estaba emocionado porque estaba en la naturaleza.

Pero los comentarios más útiles fueron sobre dónde se quedó estancada la gente:

### "¿Para quién es esto y por qué debería usarlo?"

Varias personas preguntaron esto directamente. El antiguo sitio estaba repleto de arquitectura y abstracciones. Los evaluadores querían primero un dolor agudo y específico. Uno lo comparó con vender una vitamina en lugar de un analgésico. Otro preguntó sin rodeos: "¿Soy una de las personas para las que esto es?" El sitio necesitaba responder esa pregunta en los primeros segundos.

Las nuevas páginas de casos de uso para [ingenieros de infraestructura de IA](https://neotoma.io/ai-infrastructure-engineers), [constructores de sistemas agentes](https://neotoma.io/agentic-systems-builders) y [operadores individuales nativos de IA](https://neotoma.io/ai-native-operators), además de la [comparación de modelos de memoria](https://neotoma.io/memory-models), son la respuesta directa.

### "¿Esto pretende reemplazar mi memoria existente o vivir junto a ella?"

Un evaluador técnico preguntó si Neotoma debería ser el sistema de memoria principal o sentarse junto a cosas como la memoria automática de Claude Code. Otro preguntó cómo funciona la ingestión: ¿se trata de expresiones regulares, evaluación de IA o el agente completa los parámetros de la herramienta? El sitio anterior no abordaba nada de esto. La arquitectura y la mecánica estaban dispersas en el archivo README y los documentos del repositorio.

La nueva [página de modelos de memoria](https://neotoma.io/memory-models) y el [tutorial para desarrolladores](https://neotoma.io/developer-walkthrough) abordan ambas preguntas.

### "¿Cómo configuro esto con mi herramienta?"

Un evaluador tenía Neotoma ejecutándose con la CLI pero preguntó "¿entonces no funciona con OpenClaw?" porque la lista de clientes en el sitio no estaba clara. Otro encontró un error de módulo no encontrado al intentar iniciar la API. Un tercero pasó una hora leyendo documentos en una máquina virtual nueva y marcó un enlace roto en el índice de documentación además de ventanas emergentes inesperadas de permisos de macOS. Las instrucciones de configuración estaban ocultas y variaban según la herramienta, y el fragmento de instalación del sitio carecía de un enlace directo a lo que sucede después del inicio.

La nueva [página de instalación](https://neotoma.io/install) y guías de integración para [Cursor](https://neotoma.io/neotoma-with-cursor), [Claude](https://neotoma.io/neotoma-with-claude), [Claude Code](https://neotoma.io/neotoma-with-claude-code), [ChatGPT](https://neotoma.io/neotoma-with-chatgpt), [Codex](https://neotoma.io/neotoma-with-codex) y [OpenClaw](https://neotoma.io/neotoma-with-openclaw) abordan esto.

La señal positiva detrás de todo esto: varios evaluadores hicieron funcionar Neotoma y verificaron que almacena y recupera correctamente. Uno confirmó que "almacena cosas cuando lo pido y puedo verificar con la CLI". El núcleo funciona. El sitio y la incorporación no lo hicieron.

## Página de inicio

La página de inicio ahora tiene nueve secciones distintas en lugar de un largo desplazamiento. Los tres que responden más directamente al feedback:

### Tabla de garantías de memoria

La [tabla de garantías de memoria](https://neotoma.io/memory-guarantees) es la respuesta a "¿en qué se diferencia esto?" Una comparación de la memoria de la plataforma (Claude, ChatGPT), los sistemas de recuperación (Mem0, Zep, LangChain Memory), los enfoques basados en archivos (Markdown, almacenes JSON) y Neotoma en 12 propiedades:

![Captura de pantalla: Tabla comparativa de garantías de memoria en la página de inicio de Neotoma](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png "captura de pantalla")

| Propiedad | Descripción |
| -------- | ----------- |
| [Evolución del estado determinista](https://neotoma.io/memory-guarantees#deterministic-state-evolution) | Las mismas observaciones siempre producen el mismo estado de entidad independientemente del orden. Elimina errores de pedido y hace que las transiciones de estado sean comprobables. |
| [Historial versionado](https://neotoma.io/memory-guarantees#versioned-history) | Cada cambio crea una nueva versión en lugar de sobrescribirla. Los estados anteriores siguen siendo accesibles. |
| [Línea de tiempo reproducible](https://neotoma.io/memory-guarantees#replayable-timeline) | La secuencia completa de observaciones se puede reproducir desde el principio para reconstruir cualquier estado histórico. |
| [Registro de cambios auditable](https://neotoma.io/memory-guarantees#auditable-change-log) | Cada modificación registra quién la hizo, cuándo y de qué fuente. |
| [Restricciones del esquema](https://neotoma.io/memory-guarantees#schema-constraints) | Las entidades se ajustan a tipos definidos y reglas de validación. Los datos con formato incorrecto se rechazan, no se aceptan silenciosamente. |
| [Riesgo de mutación silenciosa](https://neotoma.io/memory-guarantees#silent-mutation-risk) | Si los datos pueden cambiar sin una conciencia explícita. Los enfoques de plataforma, recuperación y basados ​​en archivos conllevan este riesgo. El neotoma lo impide. |
| [Riesgo de hechos contradictorios](https://neotoma.io/memory-guarantees#conflicting-facts-risk) | Si pueden coexistir declaraciones contradictorias sin ser detectadas. Neotoma señala y resuelve conflictos en lugar de almacenar ambos. |
| [Reconstrucción estatal reproducible](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) | El estado actual completo se puede reconstruir únicamente a partir de entradas sin procesar, de la misma manera que un libro mayor equilibra a cero sus entradas. |
| [Inspectabilidad humana](https://neotoma.io/memory-guarantees#human-inspectability) | Puede examinar exactamente qué cambió entre dos versiones y rastrear dónde se originó cada hecho. |
| [Incorporación sin configuración](https://neotoma.io/memory-guarantees#zero-setup-onboarding) | Si la memoria funciona desde el primer mensaje sin instalación. La memoria de la plataforma tiene esto. Neotoma no. |
| [Búsqueda de similitud semántica](https://neotoma.io/memory-guarantees#semantic-similarity-search) | Encontrar contexto relevante por significado en lugar de coincidencia exacta. Los sistemas de recuperación y Neotoma proporcionan esto, con alcances diferentes. |
| [Editabilidad humana directa](https://neotoma.io/memory-guarantees#direct-human-editability) | Si puede abrir el almacén de memoria en un editor estándar y modificarlo directamente. Los sistemas basados ​​en archivos tienen esto. Neotoma no. |

Cada fila enlaza con una página de explicación dedicada con ejemplos de antes/después y código CLI. Un evaluador había notado que "el almacenamiento general con esquemas no está resuelto" y que los esquemas populares podrían ser la respuesta. La tabla de garantías es mi respuesta: aquí están las propiedades específicas, aquí es donde cada enfoque funciona, aquí es donde no.

### Antes y después

![Captura de pantalla: Sección antes/después que muestra las respuestas de error y éxito](/images/posts/neotoma-site-overhaul-before-after-section.png "captura de pantalla")

La animación de introducción recorre la misma pregunta a través de dos resultados. Sin Neotoma: "No se ha encontrado contrato para Kline". Con Neotoma: "Net-30, firmado el 12 de octubre, se renueva automáticamente en el primer trimestre". Se suceden once escenarios, cada uno de los cuales muestra un modo de fallo real de un vistazo.

Debajo de la animación, cuatro tarjetas de fracaso desglosan los escenarios por tipo de datos: hechos financieros, personas y relaciones, compromisos y tareas, eventos y decisiones. Cada tarjeta tiene una narrativa concreta: contactos obsoletos que van a la persona equivocada, fechas límite olvidadas que activan recordatorios de tareas antiguas, registros contradictorios donde dos agentes leen diferentes versiones del mismo contrato y ninguno sabía que el otro existía.

Esta fue la respuesta directa a la retroalimentación "vitamina versus analgésico". El antiguo sitio estaba repleto de arquitectura. Esta sección comienza con lo que se rompe sin estado determinista y lo que eso le cuesta.

### ¿Para quién es?

![Captura de pantalla: Tres tarjetas de audiencia con ilustraciones en la página de inicio de Neotoma](/images/posts/neotoma-site-overhaul-audience-cards.png "captura de pantalla")

Tres tarjetas de audiencia con ilustraciones personalizadas: [ingenieros de infraestructura de IA](https://neotoma.io/ai-infrastructure-engineers), [constructores de sistemas agentes](https://neotoma.io/agentic-systems-builders) y [operadores individuales nativos de IA](https://neotoma.io/ai-native-operators). Cada uno enlaza a una página dedicada con modos de falla, tipos de datos y patrones de esquema específicos para esa audiencia. Esta es la respuesta directa a "¿Soy una de las personas para las que esto es?"

## Documentación

El sitio antiguo tenía todo en línea. Los evaluadores que querían profundidad tenían que acudir al repositorio. Ahora hay páginas dedicadas organizadas en una barra de navegación lateral.

### Tutorial para desarrolladores

![Captura de pantalla: página de tutorial para desarrolladores que muestra ejemplos de MCP de sesiones múltiples](/images/posts/neotoma-site-overhaul-developer-walkthrough.png "captura de pantalla")

El [tutorial para desarrolladores](https://neotoma.io/developer-walkthrough) es un escenario de varias sesiones que recorre el ciclo principal: almacenar una decisión arquitectónica en la sesión 1, recuperarla y actuar en consecuencia en la sesión 2, manejar una actualización conflictiva en la sesión 3 y luego auditar el seguimiento de observación completo. Todos los que utilizan MCP (Protocolo de contexto modelo) almacenan llamadas con ejemplos reales de solicitud/respuesta. Esto aborda directamente la cuestión de la ingestión: el agente llama a la [herramienta MCP](https://neotoma.io/mcp) con parámetros estructurados, Neotoma almacena la observación. Sin llamadas ocultas a modelos de IA, sin extracción de expresiones regulares.

### Modelos de memoria

![Captura de pantalla: página de modelos de memoria que muestra plataforma, recuperación, memoria basada en archivos y determinista](/images/posts/neotoma-site-overhaul-memory-models.png "captura de pantalla")

La página [modelos de memoria](https://neotoma.io/memory-models) compara cuatro enfoques: [memoria de plataforma](https://neotoma.io/platform-memory), [memoria de recuperación](https://neotoma.io/retrieval-memory), [memoria basada en archivos](https://neotoma.io/file-based-memory) y [memoria determinista](https://neotoma.io/deterministic-memory). Aquí es donde surge la pregunta "¿Neotoma debería reemplazar o complementar mi memoria existente?" la pregunta obtiene respuesta. Cada modelo tiene una subpágina dedicada que explica qué es, dónde funciona y dónde se estropea.

### Fundaciones

![Captura de pantalla: página de Fundamentos que muestra los compromisos de privacidad primero, deterministas y multiplataforma](/images/posts/neotoma-site-overhaul-foundations.png "captura de pantalla")

[Fundamentos](https://neotoma.io/foundations) cubre [privacidad primero](https://neotoma.io/privacy-first), determinista y [multiplataforma](https://neotoma.io/cross-platform) en profundidad. La página de privacidad responde a los evaluadores que se mostraron escépticos acerca de introducir datos personales en las herramientas de inteligencia artificial en la nube. Neotoma se ejecuta en su máquina. Tus datos permanecen locales.

### Arquitectura

![Captura de pantalla: página de arquitectura que muestra el diagrama de flujo de estado](/images/posts/neotoma-site-overhaul-architecture-state-flow.png "captura de pantalla")

La página [arquitectura](https://neotoma.io/architecture) cubre el flujo de estado (fuente, observación, entidad, instantánea de la entidad), las capas y cómo se aplican las garantías en cada etapa. Esta fue una de las incorporaciones más solicitadas.

### Páginas de referencia

Tabla completa de puntos finales de [API REST](https://neotoma.io/api), catálogo de [acciones MCP](https://neotoma.io/mcp) y [referencia de línea de comandos](https://neotoma.io/cli). La página API incluye descripciones y parámetros por punto final. La página MCP enumera las 24 acciones. La página CLI cubre los 38 comandos.

## Guías de integración

Seis páginas específicas de herramientas, cada una de las cuales recorre la configuración desde la instalación hasta la primera tienda:

- [ChatGPT](https://neotoma.io/neotoma-with-chatgpt)
- [Claude (Escritorio)](https://neotoma.io/neotoma-with-claude)
- [Código Claude](https://neotoma.io/neotoma-with-claude-code)
- [Códice](https://neotoma.io/neotoma-with-codex)
- [Cursor](https://neotoma.io/neotoma-with-cursor)
- [OpenClaw](https://neotoma.io/neotoma-with-openclaw)

![Captura de pantalla: Guía de integración de Neotoma con Claude Code](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png "captura de pantalla")

Esta es la respuesta directa a "¿funciona con X?" y "¿cómo configuro esto con mi herramienta?" Cada guía cubre la configuración, un ejemplo de primera ejecución y qué esperar. La página ChatGPT es la más detallada porque la configuración personalizada de GPT tiene la mayor cantidad de pasos. La página de OpenClaw existe porque un evaluador preguntó específicamente si era compatible y el sitio anterior era ambiguo.

## Casos de uso

Tres páginas dedicadas a la audiencia ahora resaltan y explican para quién es Neotoma, brindando orientación de orientación de la que carecía la antigua página de inicio:

![Captura de pantalla: página de audiencia de ingenieros de infraestructura de IA que muestra modos de falla y patrones de datos comunes](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastructure.png "captura de pantalla")

**[Ingenieros de infraestructura de IA](https://neotoma.io/ai-infrastructure-engineers).** Puntos débiles como ejecuciones de agentes no reproducibles, cambios de estado invisibles y falta de rastro de procedencia. Modos de falla comunes con íconos específicos. Tipos de datos con los que trabajan estos equipos (estado de sesión, canalizaciones, evaluaciones, pistas de auditoría) y los tipos de entidades que aparecen con más frecuencia (agente_sesión, acción, canalización, evaluación).

**[Constructores de sistemas agentes](https://neotoma.io/agentic-systems-builders).** Estructura similar centrada en marcos de agentes, flujos de trabajo de varios pasos y observabilidad. Modos de falla como cambios de estado silenciosos entre sesiones, flujos de trabajo que no se pueden reproducir y pérdida de contexto cuando un agente pasa el control a otro.

**[Operadores individuales nativos de IA](https://neotoma.io/ai-native-operators).** Centrado en la experiencia diaria de compromisos perdidos, pérdida de contexto de herramienta a herramienta y datos personales en la memoria opaca del proveedor. Esta es la página para el evaluador que preguntó "¿soy una de las personas a las que va dirigido esto?"

## Instalación dirigida por agentes

![Captura de pantalla: página de instalación del agente con instrucciones para copiar y pegar y demostración de la sesión del agente](/images/posts/neotoma-site-overhaul-agent-install.png "captura de pantalla")

Esto es nuevo desde el anuncio del lanzamiento del desarrollador. En lugar de leer documentos y configurar manualmente, copia un único mensaje de la [página de instalación](https://neotoma.io/install), lo pega en su herramienta de inteligencia artificial y el agente se encarga del resto: instalar el paquete, ejecutar init, configurar la conexión MCP y almacenar sus primeros datos.

El mensaje está diseñado para Claude Code, Codex, Cursor y OpenClaw. Le indica al agente que instale Neotoma con `npm install -g neotoma`, lo inicialice y luego vincule la guía de integración correspondiente para esa herramienta. El agente escanea su contexto local y la memoria de la plataforma, obtiene una vista previa de lo que encontró y almacena solo lo que usted aprueba.

Cada guía de integración enlaza con el mensaje de instalación, por lo que la ruta de incorporación es la misma independientemente de con qué herramienta comience. El objetivo es pasar de cero a una configuración de Neotoma funcional con datos reales almacenados en menos de cinco minutos, sin siquiera leer un documento de configuración.

## Soporte de idiomas

El sitio y todo el contenido de las publicaciones ahora se traducen automáticamente a 12 idiomas: árabe, bengalí, catalán, francés, alemán, hindi, indonesio, chino mandarín, portugués, ruso, español y urdu. Cada página incluye un selector de idiomas y los diseños RTL funcionan para árabe y urdu.

Esto es importante porque la versión del desarrollador ha llegado a los evaluadores fuera de los mercados de habla inglesa. En lugar de encerrar la documentación en un solo idioma, cada página (la página de inicio, las garantías de memoria, las guías de integración, las páginas de casos de uso y las publicaciones) está disponible en las 12 configuraciones regionales. Las traducciones se generan automáticamente y pueden no ser perfectas, pero reducen la barrera para cualquiera que evalúe Neotoma en su idioma principal.

## ¿Qué sigue?

La revisión del sitio aborda las lagunas de presentación y documentación. La próxima ronda de trabajo aborda las brechas de productos que surgieron los evaluadores.

- **Incorporación impulsada por agentes.** El flujo de instalación actual lo configura, pero es pasivo. Lo instalas, lo inicias y comienzas a almacenar. La próxima versión será una experiencia de descubrimiento guiado en la que su agente escaneará sus archivos locales, propondrá los candidatos de mayor valor y reconstruirá una línea de tiempo a partir de sus propios datos en los primeros minutos. El objetivo es un momento concreto en el que vea los archivos de su proyecto dispersos convertidos en una línea de tiempo estructurada con cada evento rastreado hasta una fuente específica. Ese es el momento en que se hace evidente la diferencia entre Neotoma y un recuerdo de chat.

- **Exportación de registros de Markdown.** Varios desarrolladores, especialmente los que provienen de Claude Code, esperan que la memoria se represente como archivos de Markdown que puedan explorar y editar directamente. Neotoma usa SQLite como su almacén canónico, lo que le brinda consultas deterministas y restricciones de esquema, pero significa que no puede simplemente abrir un archivo en su editor. Estoy agregando un comando para exportar sus registros como archivos de rebajas en el disco, organizados por tipo de entidad, con metadatos iniciales y procedencia. SQLite sigue siendo canónico. Los archivos de rebajas son un espejo fácil de leer para lograr transparencia e inspeccionabilidad.

- **Acceso remoto más fluido para ChatGPT y Claude.** Las guías de integración ya existen, pero las rutas de configuración remota para ChatGPT (GPT personalizado con punto final API) y Claude (Escritorio con MCP remoto) necesitan más de mi propia prueba interna y depuración antes de que sean tan fluidas como las rutas locales para Cursor y Claude Code. Quiero que ambos funcionen de manera confiable de un extremo a otro y actualizar las guías con instrucciones y solución de problemas más claras.

## Sobre qué quiero comentarios

La versión para desarrolladores todavía está activa. Si intenta instalar Neotoma y trabajar en el sitio, quiero saber:

- ¿Está claro el posicionamiento? Cuando llegas a la página de inicio, ¿comprendes qué hace Neotoma y en qué se diferencia de lo que ya utilizas?
- ¿La tabla de garantías de memoria le ayuda a decidir si Neotoma es relevante para su flujo de trabajo?
- ¿Está clara la ruta de instalación e incorporación? ¿Puedes llegar desde el sitio a una configuración de trabajo sin chocar contra una pared?
- ¿Las guías de integración son precisas para su herramienta?

Visite [neotoma.io](https://neotoma.io), solicite a su agente que [instale](https://neotoma.io/install) con las instrucciones de copiar y pegar y comparta sus comentarios. Abra una incidencia en [GitHub](https://github.com/markmhendrickson/neotoma) o comuníquese directamente.