J'ai remanié le site [Neotoma](https://neotoma.io). L'ancien mur de texte d'une seule page est désormais une présentation visuelle soutenue par une [documentation complète](https://neotoma.io/docs), des guides d'intégration spécifiques aux outils et des [analyses approfondies de l'architecture](https://neotoma.io/architecture). La plupart de ce qui a changé remonte à quelque chose qu'un testeur a dit ou sur lequel il est resté bloqué lors de la version développeur.

![Capture d'écran : Hero de la page d'accueil de Neotoma — accessoire de valeur et session d'agent sans couche d'état](/images/posts/neotoma-site-overhaul-home-hero.png "screenshot")

## Ce que les commentaires m'ont dit

Depuis l'annonce de la [version développeur](/posts/neotoma-developer-release), j'ai recueilli les commentaires d'une douzaine de testeurs via des appels, des discussions, des e-mails et des enregistrements d'écran. Le sentiment est encourageant. Une personne l'a qualifié de "problème très pertinent" et a noté que "la plupart des gens roulent eux-mêmes en ce moment". Un autre a déclaré que cela semblait être un problème qui méritait d’être résolu. Quelqu'un d'autre était juste excité d'être dans la nature.

Mais les commentaires les plus utiles concernaient les points où les gens étaient bloqués :

### "À qui s'adresse-t-il et pourquoi devrais-je l'utiliser ?"

Plusieurs personnes ont posé cette question directement. L'ancien site était dominé par l'architecture et les abstractions. Les testeurs voulaient d’abord une douleur aiguë et spécifique. L’un d’entre eux l’a comparé à la vente d’une vitamine au lieu d’un analgésique. Un autre a demandé catégoriquement : « Suis-je une des personnes à qui cela s’adresse ? Le site devait répondre à cette question dans les premières secondes.

Les nouvelles pages de cas d'utilisation pour les [ingénieurs en infrastructure IA](https://neotoma.io/ai-infrastructure-engineers), les [constructeurs de systèmes agentiques](https://neotoma.io/agentic-systems-builders) et les [opérateurs individuels natifs d'IA](https://neotoma.io/ai-native-operators), ainsi que la [comparaison des modèles de mémoire](https://neotoma.io/memory-models), sont la réponse directe.

### "Est-ce destiné à remplacer ma mémoire existante ou à vivre à côté d'elle ?"

Un testeur technique a demandé si Neotoma devait être le système de mémoire principal ou s'asseoir aux côtés d'éléments comme la mémoire automatique de Claude Code. Un autre a demandé comment fonctionne l'ingestion : s'agit-il d'une regex, d'une évaluation de l'IA ou de l'agent qui remplit les paramètres de l'outil ? L'ancien site ne traitait de rien de tout cela. L'architecture et la mécanique étaient dispersées dans les documents README et repo.

La nouvelle [page des modèles de mémoire](https://neotoma.io/memory-models) et la [procédure pas à pas du développeur](https://neotoma.io/developer-walkthrough) répondent aux deux questions.

### "Comment puis-je configurer cela avec mon outil ?"

Un testeur a fait fonctionner Neotoma avec la CLI mais a demandé « donc ça ne fonctionne pas avec OpenClaw ? parce que la liste des clients sur le site n'était pas claire. Un autre a rencontré une erreur de module introuvable en essayant de démarrer l'API. Un troisième a passé une heure à lire des documents sur une nouvelle VM et a signalé un lien rompu dans l'index de la documentation ainsi que des fenêtres contextuelles d'autorisation macOS inattendues. Les instructions d'installation étaient enterrées et variaient selon l'outil, et l'extrait d'installation du site manquait de lien direct vers ce qui se passait après l'initialisation.

La nouvelle [page d'installation](https://neotoma.io/install) et les guides d'intégration pour [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) et [OpenClaw](https://neotoma.io/neotoma-with-openclaw) résolvent ce problème.

Le signal positif derrière tout cela : plusieurs testeurs ont fait fonctionner Neotoma et ont vérifié qu'il stocke et récupère correctement. L'un d'eux a confirmé qu'il "stocke des éléments lorsque je le demande et peut vérifier avec la CLI". Le noyau fonctionne. Le site et l’intégration ne l’ont pas fait.

## Page d'accueil

La page d'accueil comporte désormais neuf sections distinctes au lieu d'un long défilement. Les trois qui répondent le plus directement aux commentaires :

### Tableau des garanties de mémoire

Le [tableau des garanties de mémoire](https://neotoma.io/memory-guarantees) est la réponse à la question « en quoi est-ce différent ? » Une comparaison de la mémoire de la plateforme (Claude, ChatGPT), des systèmes de récupération (Mem0, Zep, LangChain Memory), des approches basées sur les fichiers (Markdown, magasins JSON) et de Neotoma sur 12 propriétés :

![Capture d'écran : Tableau de comparaison des garanties de mémoire sur la page d'accueil de Neotoma](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png "screenshot")

| Propriété | Descriptif |
| -------- | ----------- |
| [Évolution de l'état déterministe](https://neotoma.io/memory-guarantees#deterministic-state-evolution) | Les mêmes observations produisent toujours le même état d'entité, quel que soit l'ordre. Élimine les bogues de classement et rend les transitions d'état testables. |
| [Historique versionné](https://neotoma.io/memory-guarantees#versioned-history) | Chaque modification crée une nouvelle version au lieu de l'écraser. Les états antérieurs restent accessibles. |
| [Chronologie rejouable](https://neotoma.io/memory-guarantees#replayable-timeline) | La séquence complète des observations peut être rejouée depuis le début pour reconstituer n’importe quel état historique. |
| [Journal des modifications auditables](https://neotoma.io/memory-guarantees#auditable-change-log) | Chaque modification enregistre qui l'a effectuée, quand et à partir de quelle source. |
| [Contraintes de schéma](https://neotoma.io/memory-guarantees#schema-constraints) | Les entités se conforment aux types définis et aux règles de validation. Les données mal formées sont rejetées et non acceptées en silence. |
| [Risque de mutation silencieuse](https://neotoma.io/memory-guarantees#silent-mutation-risk) | Si les données peuvent changer sans conscience explicite. Les approches basées sur les plates-formes, la récupération et les fichiers comportent toutes ce risque. Le néotome l'empêche. |
| [Risque de faits contradictoires](https://neotoma.io/memory-guarantees#conflicting-facts-risk) | Si des déclarations contradictoires peuvent coexister sans détection. Neotoma signale et résout les conflits au lieu de stocker les deux. |
| [Reconstruction d'état reproductible](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) | L'état actuel complet peut être reconstruit à partir des seules entrées brutes, de la même manière qu'un grand livre s'équilibre à zéro à partir de ses écritures. |
| [Inspectabilité humaine](https://neotoma.io/memory-guarantees#human-inspectability) | Vous pouvez examiner exactement ce qui a changé entre deux versions et retracer l’origine de chaque fait. |
| [Intégration sans configuration](https://neotoma.io/memory-guarantees#zero-setup-onboarding) | Si la mémoire fonctionne dès le premier message sans installation. La mémoire de la plate-forme a ceci. Ce n’est pas le cas du néotome. |
| [Recherche de similarité sémantique](https://neotoma.io/memory-guarantees#semantic-similarity-search) | Trouver un contexte pertinent par le sens plutôt que par une correspondance exacte. Les systèmes de récupération et Neotoma fournissent tous deux cela, avec une portée différente. |
| [Modification humaine directe](https://neotoma.io/memory-guarantees#direct-human-editability) | Si vous pouvez ouvrir la mémoire dans un éditeur standard et la modifier directement. Les systèmes basés sur des fichiers ont cela. Ce n’est pas le cas du néotome. |

Chaque ligne renvoie à une page d'explication dédiée avec des exemples avant/après et du code CLI. Un testeur avait noté que « le stockage général avec des schémas n'est pas résolu » et que les schémas populaires pourraient être la réponse. Le tableau des garanties est ma réponse : voici les propriétés spécifiques, voici où chaque approche est efficace, voici où elle ne l'est pas.

### Avant et après

![Capture d'écran : Section avant/après montrant les réponses d'échec et de réussite](/images/posts/neotoma-site-overhaul-before-after-section.png "screenshot")

L'animation d'introduction fait défiler la même question à travers deux résultats. Sans Neotoma : "Aucun contrat trouvé pour Kline." Avec Neotoma : "Net-30, signé le 12 octobre, se renouvelle automatiquement au premier trimestre." Onze scénarios alternent, chacun montrant un véritable mode de défaillance en un coup d'œil.

Sous l'animation, quatre cartes d'échec répartissent les scénarios par type de données : faits financiers, personnes et relations, engagements et tâches, événements et décisions. Chaque carte a un récit concret : des contacts périmés adressés à la mauvaise personne, des délais oubliés déclenchant des rappels pour d'anciennes tâches, des enregistrements contradictoires dans lesquels deux agents lisent des versions différentes du même contrat et aucun des deux ne savait que l'autre existait.

C’était la réponse directe aux commentaires « vitamines contre analgésiques ». L'ancien site est dominé par l'architecture. Cette section présente ce qui casse sans état déterministe et ce que cela vous coûte.

### C'est pour qui

![Capture d'écran : Trois fiches d'audience avec illustrations sur la page d'accueil de Neotoma](/images/posts/neotoma-site-overhaul-audience-cards.png "screenshot")

Trois fiches d'audience avec des illustrations personnalisées : [Ingénieurs en infrastructure IA](https://neotoma.io/ai-infrastructure-engineers), [constructeurs de systèmes agentiques](https://neotoma.io/agentic-systems-builders) et [Opérateurs individuels natifs d'IA](https://neotoma.io/ai-native-operators). Chacun renvoie à une page dédiée avec les modes de défaillance, les types de données et les modèles de schéma spécifiques à ce public. C'est la réponse directe à la question « Suis-je l'une des personnes à qui cela s'adresse ? »

##Documents

L'ancien site avait tout en ligne. Les testeurs qui voulaient de la profondeur devaient se rendre au repo. Il existe désormais des pages dédiées organisées dans une barre de navigation latérale.

### Présentation pas à pas du développeur

![Capture d'écran : page de présentation du développeur montrant des exemples de MCP multi-session](/images/posts/neotoma-site-overhaul-developer-walkthrough.png "screenshot")

La [procédure pas à pas du développeur](https://neotoma.io/developer-walkthrough) est un scénario multi-sessions qui parcourt la boucle principale : stocker une décision architecturale dans la session 1, la récupérer et agir dessus dans la session 2, gérer une mise à jour conflictuelle dans la session 3, puis auditer la piste d'observation complète. Tous utilisant MCP (Model Context Protocol) stockent les appels avec de vrais exemples de requête/réponse. Cela répond directement à la question d'ingestion : l'agent appelle l'[outil MCP](https://neotoma.io/mcp) avec des paramètres structurés, Neotoma stocke l'observation. Pas d'appels de modèle d'IA cachés, pas d'extraction d'expressions régulières.

### Modèles de mémoire

![Capture d'écran : page des modèles de mémoire montrant la mémoire de plate-forme, de récupération, basée sur des fichiers et déterministe](/images/posts/neotoma-site-overhaul-memory-models.png "screenshot")

La page [modèles de mémoire](https://neotoma.io/memory-models) compare quatre approches : [mémoire de plate-forme](https://neotoma.io/platform-memory), [mémoire de récupération](https://neotoma.io/retrieval-memory), [mémoire basée sur des fichiers](https://neotoma.io/file-based-memory) et [mémoire déterministe mémoire](https://neotoma.io/deterministic-memory). C'est ici que se pose la question « Neotoma devrait-il remplacer ou compléter ma mémoire existante ? » la question obtient une réponse. Chaque modèle dispose d'une sous-page dédiée expliquant de quoi il s'agit, où il fonctionne et où il échoue.

### Fondations

![Capture d'écran : Page des fondations montrant les engagements axés sur la confidentialité, déterministes et multiplateformes](/images/posts/neotoma-site-overhaul-foundations.png "screenshot")

[Foundations](https://neotoma.io/foundations) couvre [privacy-first](https://neotoma.io/privacy-first), déterministe et [cross-platform](https://neotoma.io/cross-platform) en profondeur. La page axée sur la confidentialité répond aux testeurs qui étaient sceptiques quant à l’introduction de données personnelles dans les outils d’IA cloud. Neotoma fonctionne sur votre machine. Vos données restent locales.

### Architecture

![Capture d'écran : Page d'architecture montrant le diagramme de flux d'état](/images/posts/neotoma-site-overhaul-architecture-state-flow.png "screenshot")

La page [architecture](https://neotoma.io/architecture) couvre le flux d'état (source, observation, entité, instantané d'entité), les couches et la manière dont les garanties sont appliquées à chaque étape. C’était l’un des ajouts les plus demandés.

### Pages de référence

Tableau complet des points de terminaison [API REST](https://neotoma.io/api), catalogue [actions MCP](https://neotoma.io/mcp) et [référence de ligne de commande](https://neotoma.io/cli). La page API comprend des descriptions et des paramètres par point de terminaison. La page MCP répertorie les 24 actions. La page CLI couvre les 38 commandes.

## Guides d'intégration

Six pages spécifiques aux outils, chacune parcourant la configuration, de l'installation au premier stockage :

- [ChatGPT](https://neotoma.io/neotoma-with-chatgpt)
- [Claude (Bureau)](https://neotoma.io/neotoma-with-claude)
- [Claude Code](https://neotoma.io/neotoma-with-claude-code)
- [Codex](https://neotoma.io/neotoma-with-codex)
- [Curseur](https://neotoma.io/neotoma-with-cursor)
- [OpenClaw](https://neotoma.io/neotoma-with-openclaw)

![Capture d'écran : Guide d'intégration de Neotoma avec Claude Code](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png "screenshot")

C'est la réponse directe à la question « est-ce que ça marche avec X ? » et "comment puis-je configurer cela avec mon outil ?" Chaque guide couvre la configuration, un exemple de première exécution et à quoi s'attendre. La page ChatGPT est la plus détaillée car la configuration GPT personnalisée comporte le plus d'étapes. La page OpenClaw existe parce qu'un testeur a spécifiquement demandé si elle était prise en charge et que l'ancien site était ambigu.

## Cas d'utilisation

Trois pages d'audience dédiées mettent désormais en évidence et expliquent à qui s'adresse Neotoma, fournissant des conseils de ciblage qui manquaient à l'ancienne page d'accueil :

![Capture d'écran : page d'audience des ingénieurs d'infrastructure IA montrant les modes de défaillance et les modèles de données courants](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastructure.png "screenshot")

**[Ingénieurs en infrastructure IA](https://neotoma.io/ai-infrastructure-engineers).** Problèmes tels que les exécutions d'agents non reproductibles, les changements d'état invisibles et l'absence de trace de provenance. Modes de défaillance courants avec des icônes spécifiques. Types de données avec lesquels ces équipes travaillent (état de session, pipelines, évaluations, pistes d'audit) et types d'entités qui reviennent le plus souvent (agent_session, action, pipeline, évaluation).

**[Constructeurs de systèmes agentiques](https://neotoma.io/agentic-systems-builders).** Structure similaire axée sur les cadres d'agents, les flux de travail en plusieurs étapes et l'observabilité. Modes de défaillance tels que les changements d'état silencieux entre les sessions, les flux de travail qui ne peuvent pas être rejoués et la perte de contexte lorsqu'un agent passe le relais à un autre.

**[Opérateurs individuels natifs d'IA](https://neotoma.io/ai-native-operators).** Axé sur l'expérience quotidienne des engagements perdus, de la perte de contexte d'un outil à l'autre et des données personnelles dans la mémoire opaque du fournisseur. Il s'agit de la page destinée au testeur qui a demandé : « Suis-je l'une des personnes à qui cela s'adresse ? »

## Installation dirigée par un agent

![Capture d'écran : page d'installation de l'agent avec instructions de copier-coller et démo de session d'agent](/images/posts/neotoma-site-overhaul-agent-install.png "screenshot")

C'est nouveau depuis l'annonce de la sortie du développeur. Au lieu de lire des documents et de configurer manuellement, vous copiez une seule invite de la [page d'installation](https://neotoma.io/install), collez-la dans votre outil d'IA et l'agent s'occupe du reste : installation du package, exécution d'init, configuration de la connexion MCP et stockage de vos premières données.

L'invite est conçue pour Claude Code, Codex, Cursor et OpenClaw. Il indique à l'agent d'installer Neotoma avec `npm install -g neotoma`, de l'initialiser, puis de lier le guide d'intégration correspondant à cet outil. L'agent analyse votre contexte local et la mémoire de votre plateforme, prévisualise ce qu'il a trouvé et stocke uniquement ce que vous approuvez.

Chaque guide d'intégration renvoie à l'invite d'installation afin que le chemin d'intégration soit le même quel que soit l'outil avec lequel vous démarrez. L'objectif est de passer de zéro à une configuration Neotoma fonctionnelle avec des données réelles stockées en moins de cinq minutes, sans jamais lire un document de configuration.

## Prise en charge linguistique

Le site et tout le contenu des publications sont désormais automatiquement traduits en 12 langues : arabe, bengali, catalan, français, allemand, hindi, indonésien, chinois mandarin, portugais, russe, espagnol et ourdou. Chaque page comprend un sélecteur de langue et les mises en page RTL fonctionnent pour l'arabe et l'ourdou.

Cela est important car la version développeur a atteint les testeurs en dehors des marchés anglophones. Plutôt que de regrouper la documentation dans une seule langue, chaque page (la page d'accueil, les garanties de mémoire, les guides d'intégration, les pages de cas d'utilisation et les publications) est disponible dans les 12 paramètres régionaux. Les traductions sont générées automatiquement et ne sont peut-être pas parfaites, mais elles abaissent la barrière pour quiconque évalue Neotoma dans sa langue principale.

## Quelle est la prochaine étape

La refonte du site comble les lacunes de présentation et de documentation. La prochaine série de travaux aborde les lacunes du produit signalées par les testeurs.

- **Intégration pilotée par l'agent.** Le flux d'installation actuel vous permet de vous configurer, mais il est passif. Vous installez, vous initialisez, vous commencez à stocker. La prochaine version sera une expérience de découverte guidée dans laquelle votre agent analysera vos fichiers locaux, proposera les candidats les plus intéressants et reconstruira une chronologie à partir de vos propres données dans les premières minutes. L'objectif est un moment concret où vous voyez vos fichiers de projet dispersés transformés en une chronologie structurée avec chaque événement rattaché à une source spécifique. C'est à ce moment-là que la différence entre Neotoma et une mémoire de chat devient évidente.

- **Export d'enregistrement Markdown.** Plusieurs développeurs, notamment ceux issus de Claude Code, s'attendent à ce que la mémoire soit représentée sous forme de fichiers markdown qu'ils peuvent parcourir et éditer directement. Neotoma utilise SQLite comme magasin canonique, ce qui vous propose des requêtes déterministes et des contraintes de schéma, mais signifie que vous ne pouvez pas simplement ouvrir un fichier dans votre éditeur. J'ajoute une commande pour exporter vos enregistrements sous forme de fichiers markdown sur le disque, organisés par type d'entité, avec métadonnées et provenance. SQLite reste canonique. Les fichiers de démarques sont un miroir facile à lire pour la transparence et l'inspectabilité.

- **Accès à distance plus fluide pour ChatGPT et Claude.** Les guides d'intégration existent maintenant, mais les chemins de configuration à distance pour ChatGPT (GPT personnalisé avec point de terminaison API) et Claude (bureau avec MCP distant) nécessitent davantage de mon propre dogfooding et débogage avant d'être aussi fluides que les chemins locaux pour Cursor et Claude Code. Je souhaite que les deux fonctionnent de manière fiable de bout en bout et mettre à jour les guides avec des instructions et un dépannage plus clairs.

## Sur quoi je souhaite recevoir des commentaires

La version développeur est toujours active. Si vous essayez d'installer Neotoma et de travailler sur le site, je veux savoir :

- Le positionnement est-il clair ? Lorsque vous arrivez sur la page d'accueil, comprenez-vous ce que fait Neotoma et en quoi il diffère de ce que vous utilisez déjà ?
- Le tableau des garanties de mémoire vous aide-t-il à décider si Neotoma est pertinent pour votre flux de travail ?
- Le chemin d'installation et d'intégration est-il clair ? Pouvez-vous passer du site à une configuration fonctionnelle sans heurter un mur ?
- Les guides d'intégration sont-ils précis pour votre outil ?

Visitez [neotoma.io](https://neotoma.io), demandez à votre agent d'[installer](https://neotoma.io/install) avec les instructions de copier-coller et partagez vos commentaires. Ouvrez un problème sur [GitHub](https://github.com/markmhendrickson/neotoma) ou contactez-le directement.