El Neotoma és una capa de memòria estructurada per a agents d'IA. Tracta les dades personals de la mateixa manera que els sistemes de producció tracten l'estat: entitats mecanografiades, identificacions estables, procedència completa, consultes deterministes. Aquesta versió per a desenvolupadors està disponible ara. Instal·leu-lo mitjançant npm, connecteu les vostres eines d'IA mitjançant MCP i executeu-lo a la vostra màquina. Documentació i configuració: [neotoma.io](https://neotoma.io). Repositori: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). ## El problema He passat l'any passat executant fluxos de treball mitjançant agents d'IA: correu electrònic, tasques, finances, contactes, contingut. Els agents són capaços. El problema és la confiança. La memòria canvia implícitament. El context deriva. L'agent dóna una resposta diferent a la mateixa pregunta en una nova sessió. Sobreescriu un contacte i l'estat anterior desapareixerà. No puc rastrejar un número equivocat fins a la seva font. No puc utilitzar els mateixos registres d'una eina diferent. Aquests no són casos extrems. Apareixen tan bon punt els agents gestionen l'estat en curs: tasques, transaccions, compromisos, relacions. Com més delego, més afilats són els límits. El que continua trencant no és la intel·ligència. És confiança. Vaig escriure sobre això per primera vegada a [Creació d'una capa de veritat per a la memòria de l'agent persistent](/posts/truth-layer-agent-memory). ## On la memòria actual es queda curta La majoria de la memòria de l'agent actual és la recuperació: RAG, cerca d'agent, similitud incrustada, memòria controlada pel proveïdor. Treballs de recuperació d'exploració i preguntes puntuals. Es desfà per estat en curs. [RAG s'omple de resultats redundants](/posts/why-agent-memory-needs-more-than-rag) quan la memòria de l'agent és un flux limitat i coherent. Top-k retorna la repetició en lloc del que necessiteu. Cadenes de proves de fragments de poda. La semblança ignora l'estructura. La memòria del proveïdor (ChatGPT Memory, Claude Projects) és només per a converses i està vinculada a la plataforma. És opac, no té procedència ni retrocés i no funciona amb les eines. No podeu consultar-lo de manera determinista ni rastrejar un fet fins a la seva font. [Cerca agent](/posts/recerca-agent-i-capa-de-veritat) torna a inferir cada sessió. Cap identitat canònica persistent, cap garantia que la mateixa pregunta produeixi el mateix resultat. Funciona per a la codificació i l'exploració. Per a tasques, contactes, transaccions i esdeveniments, necessiteu la mateixa resposta la setmana vinent, conjunts complets i pistes d'auditoria. La recuperació no ofereix això. La [divisió útil](/posts/agent-memory-truth-problem) és la recuperació versus l'estat estructurat, no el gràfic versus la reducció. La recuperació s'optimitza per a la rellevància i el descobriment. L'estat estructurat optimitza la coherència, la integritat i la procedència. Els grans projectes (Zep, Mem0, Letta, LangMem) estan afegint estructura, però la convergència total s'enfronta a barreres arquitectòniques. Quan els agents actuen en nom vostre, necessiteu aquest últim. He escrit per separat sobre les [sis tendències estructurals](/posts/six-agentic-trends-betting-on) que fan que aquesta bretxa s'ampliï amb el pas del temps: els agents s'estan convertint en estat, els errors tenen un preu, les plataformes es mantenen opaques, les eines es mantenen fragmentades. ## Què és Neotoma Neotoma és una capa de veritat: el substrat de memòria que es troba sota els vostres agents. Els agents segueixen fent el que fan (eines de navegació, escriptura, trucades). Neotoma és propietari de l'estat que llegeixen i escriuen. Pengeu documents o compartiu informació a les converses d'agents. Neotoma resol entitats a través de fonts. Persones, empreses, tasques, factures, esdeveniments obtenen identificacions estables. Cada fet remunta al seu origen. Les línies de temps provenen dels camps de data. Les correccions conserven l'historial en lloc de sobreescriure-lo. El gràfic és independent de l'execució. Modela el que existeix, no com es fa la feina. Les mateixes dades estan disponibles a Cursor, ChatGPT, Claude o qualsevol client MCP. Quan [canvieu les eines](/posts/openclaw-and-the-truth-layer), la memòria no es mou. No és una aplicació per prendre notes ni un "segon cervell". Memòria no controlada pel proveïdor. No és una botiga de vectors ni una capa RAG. No és un agent autònom. És el primer estat estructurat de l'esquema que controleu. ## Què inclou aquesta versió Aquesta versió per a desenvolupadors exposa el contracte bàsic: - **CLI** per a humans. - **MCP** per als agents (ChatGPT, Claude, Cursor, Claude Code); els agents utilitzen MCP com a còpia de seguretat. - **OpenAPI** com a font única de veritat. Funcionalitat concreta: - **Emmagatzematge de doble camí.** Carregueu fitxers o escriviu dades estructurades de converses d'agent en un gràfic. - **Resolució d'entitats.** Els identificadors canònics basats en hash unifiquen la mateixa entitat en totes les fonts. - **Registre d'esquemes.** Entitats escrites i relacions mecanografiades. Els esquemes evolucionen a mesura que ho fan les dades. - **Línees de temps.** Generació automàtica de línies de temps a partir dels camps de data de totes les entitats. - **Procedència completa.** Tots els registres es remunten a la seva font. Les correccions creen noves observacions, no sobreescritures. - **Recuperació estructural.** Consulta per tipus d'entitat, identificador, relació o interval de temps. Veïnatge gràfic per al raonament entre entitats. No hi ha cap aplicació web. Això és una infraestructura, no un producte. Les interfícies són CLI, MCP i API. ## Principis i per què el local-primer Tres fonaments configuren el disseny: **Primer la privadesa.** Les teves dades es mantenen a la teva màquina. Només emmagatzematge local: fitxers SQLite i locals. Sense dependència del núvol. No s'ha utilitzat mai per a l'entrenament. Tu controles el que entra i el que es queda. **Determinista.** Mateixa entrada, mateixa sortida. Identificadors d'entitat basats en hash. Esquema-primera extracció. No hi ha LLM al camí crític per a l'emmagatzematge o la recuperació. Procedència completa a cada registre. ** Multiplataforma.** Una capa de memòria entre eines. ChatGPT, Claude, Cursor i Claude Code es connecten mitjançant MCP. Sense bloqueig de proveïdor. Canvia les eines i la memòria es mantindrà igual. Aquesta versió és només local per disseny. La confiança comença amb el control. Abans d'afegir infraestructura remota, el contracte i les garanties han de ser sòlids. Només local significa que podeu verificar tot el que fa el sistema. Aquest és el punt de partida adequat per a una capa que diu ser fiable. ## Per a qui és això Els desenvolupadors i els creadors d'agents es troben còmodes amb els fluxos de treball CLI-first. Persones que construeixen o operen sistemes agents que necessiten memòria persistent a través de sessions i eines. Qualsevol persona que tracti dades personals com una infraestructura de producció. No per a (encara): els usuaris de la interfície d'usuari primer, la presa de notes casuals o qualsevol persona que espere garanties d'estabilitat avui. S'han d'esperar canvis de ruptura. Aquest llançament existeix per provar la pressió dels fonaments. ## Instal·la i connecta ```bash npm install -g neotoma # instal·lar neotoma init # inicialitzar neotoma # inicia sessió interactiva ``` Configuració completa, documents de l'API, configuració MCP i referència d'esquema: [neotoma.io](https://neotoma.io). Repositori: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). ## Menjar per emportar - **Primer la privadesa.** Les teves dades a la teva màquina; només local, sense núvol, mai utilitzat per a la formació. - **CLI, MCP, OpenAPI.** Un contracte per a persones i agents. - **Estat estructurat primer esquema.** Entitats tipificades, procedència completa, consultes deterministes. ## Prova-ho, trenca-ho, digues-me M'agradaria la teva ajuda per endurir això. Executeu-ho. Casos de punta. Informa d'errors, comportaments confús o peces que falten. Els comentaris que més valoro: on fallen les garanties, on el contracte s'interposa, on el disseny fa una compensació equivocada. Obriu problemes a GitHub, envieu pedaços o inicieu una discussió. Aquest llançament és dur a propòsit. La fiabilitat prové de l'ús real i de la retroalimentació real, no del poliment aïllat.