Ich habe die [Neotoma](https://neotoma.io)-Website überarbeitet. Die alte einseitige Textwand ist jetzt eine visuelle Präsentation, die durch [vollständige Dokumentation](https://neotoma.io/docs), werkzeugspezifische Integrationshandbücher und [tiefe Einblicke in die Architektur](https://neotoma.io/architecture) unterstützt wird. Das meiste, was sich geändert hat, geht auf etwas zurück, was ein Tester gesagt hat oder woran er während der Entwicklerfreigabe hängengeblieben ist.

![Screenshot: Neotoma-Homepage-Held – Value-Prop- und Agent-Sitzung ohne Statusebene](/images/posts/neotoma-site-overhaul-home-hero.png „screenshot“)

## Was mir das Feedback verriet

Seit der Ankündigung der [Entwicklerversion](/posts/neotoma-developer-release) habe ich Feedback von etwa einem Dutzend Testern über Anrufe, Chats, E-Mails und Bildschirmaufzeichnungen gesammelt. Die Stimmung war ermutigend. Eine Person nannte es „ein sehr relevantes Problem“ und bemerkte, dass „die meisten Leute gerade ihr eigenes Problem lösen“. Ein anderer sagte, es klinge nach einem Problem, das es wert sei, gelöst zu werden. Jemand anderes war gerade aufgepumpt, es ging raus in die Wildnis.

Aber das nützlichste Feedback betraf die Frage, wo die Leute stecken geblieben sind:

### „Für wen ist das gedacht und warum sollte ich es verwenden?“

Mehrere Personen haben dies direkt gefragt. Der alte Standort führte mit Architektur und Abstraktionen. Die Tester wollten zunächst akute, spezifische Schmerzen. Einer verglich es mit dem Verkauf eines Vitamins statt eines Schmerzmittels. Ein anderer fragte direkt: „Bin ich einer der Menschen, für die das ist?“ Die Website musste diese Frage in den ersten Sekunden beantworten.

Die neuen Anwendungsfallseiten für [KI-Infrastrukturingenieure](https://neotoma.io/ai-infrastructure-engineers), [Entwickler von Agentensystemen](https://neotoma.io/agentic-systems-builders) und [KI-native Einzelbetreiber](https://neotoma.io/ai-native-operators) sowie der [Vergleich von Speichermodellen](https://neotoma.io/memory-models) sind die direkte Antwort.

### „Soll dies mein vorhandenes Gedächtnis ersetzen oder neben ihm weiterleben?“

Ein technischer Tester fragte, ob Neotoma das primäre Speichersystem sein oder neben Dingen wie dem automatischen Speicher von Claude Code stehen sollte. Ein anderer fragte, wie die Aufnahme funktioniert: Ist es Regex, KI-Auswertung oder gibt der Agent Werkzeugparameter ein? Auf der alten Seite wurde nichts davon angesprochen. Die Architektur und Mechanik waren über die README- und Repo-Dokumente verteilt.

Die neue [Seite zu Speichermodellen](https://neotoma.io/memory-models) und die [Komplettlösung für Entwickler](https://neotoma.io/developer-walkthrough) befassen sich mit beiden Fragen.

### „Wie richte ich das mit meinem Tool ein?“

Ein Tester ließ Neotoma mit der CLI laufen, fragte aber: „Funktioniert es also nicht mit OpenClaw?“ weil die Kundenliste auf der Website unklar war. Bei einem weiteren Fehler trat beim Versuch, die API zu starten, der Fehler „Modul nicht gefunden“ auf. Ein Drittel verbrachte eine Stunde damit, Dokumente auf einer neuen VM zu lesen und meldete einen defekten Link im Dokumentationsindex sowie unerwartete macOS-Berechtigungs-Popups. Die Installationsanweisungen waren vergraben und variierten je nach Tool, und im Installations-Snippet der Site fehlte ein direkter Link zu dem, was nach der Init-Initialisierung passiert.

Die neue [Installationsseite](https://neotoma.io/install) und Integrationshandbücher für [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) und [OpenClaw](https://neotoma.io/neotoma-with-openclaw) befassen sich damit.

Das positive Signal hinter all dem: Mehrere Tester haben Neotoma in Betrieb genommen und überprüft, dass es korrekt speichert und abruft. Einer bestätigte, dass es „Sachen speichert, wenn ich es frage, und es mit der CLI überprüfen kann“. Der Kern funktioniert. Die Website und das Onboarding taten es nicht.

## Startseite

Die Startseite besteht jetzt aus neun verschiedenen Abschnitten anstelle einer langen Schriftrolle. Die drei, die am direktesten auf das Feedback reagieren:

### Speichergarantietabelle

Die [Speichergarantietabelle](https://neotoma.io/memory-guarantees) ist die Antwort auf die Frage „Wie ist das anders?“ Ein Vergleich von Plattformspeicher (Claude, ChatGPT), Abrufsystemen (Mem0, Zep, LangChain Memory), dateibasierten Ansätzen (Markdown, JSON Stores) und Neotoma über 12 Eigenschaften hinweg:

![Screenshot: Speichergarantie-Vergleichstabelle auf der Neotoma-Homepage](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png „screenshot“)

| Eigentum | Beschreibung |
| -------- | ----------- |
| [Deterministische Zustandsentwicklung](https://neotoma.io/memory-guarantees#deterministic-state-evolution) | Gleiche Beobachtungen erzeugen unabhängig von der Reihenfolge immer denselben Entitätszustand. Beseitigt Bestellfehler und macht Zustandsübergänge testbar. |
| [Versionierter Verlauf](https://neotoma.io/memory-guarantees#versioned-history) | Bei jeder Änderung wird eine neue Version erstellt, anstatt sie zu überschreiben. Frühere Staaten bleiben zugänglich. |
| [Wiederholbare Zeitleiste](https://neotoma.io/memory-guarantees#replayable-timeline) | Die gesamte Beobachtungssequenz kann von Anfang an wiederholt werden, um jeden historischen Zustand zu rekonstruieren. |
| [Überprüfbares Änderungsprotokoll](https://neotoma.io/memory-guarantees#auditable-change-log) | Bei jeder Änderung wird aufgezeichnet, wer sie wann und aus welcher Quelle erstellt hat. |
| [Schemaeinschränkungen](https://neotoma.io/memory-guarantees#schema-constraints) | Entitäten entsprechen definierten Typen und Validierungsregeln. Fehlerhafte Daten werden abgelehnt und nicht stillschweigend akzeptiert. |
| [Stilles Mutationsrisiko](https://neotoma.io/memory-guarantees#silent-mutation-risk) | Ob sich Daten ohne explizites Wissen ändern können. Plattform-, abruf- und dateibasierte Ansätze bergen alle dieses Risiko. Neotoma verhindert dies. |
| [Risiko widersprüchlicher Fakten](https://neotoma.io/memory-guarantees#conflicting-facts-risk) | Ob widersprüchliche Aussagen ohne Entdeckung nebeneinander existieren können. Neotoma markiert und löst Konflikte, anstatt beides zu speichern. |
| [Reproduzierbare Zustandsrekonstruktion](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) | Der vollständige aktuelle Status kann allein aus Roheingaben wiederhergestellt werden, so wie ein Hauptbuch seine Einträge auf Null bringt. |
| [Menschliche Inspectability](https://neotoma.io/memory-guarantees#human-inspectability) | Sie können genau untersuchen, was sich zwischen zwei beliebigen Versionen geändert hat, und nachverfolgen, woher jeder Fakt stammt. |
| [Zero-Setup-Onboarding](https://neotoma.io/memory-guarantees#zero-setup-onboarding) | Ob der Speicher ab der ersten Nachricht ohne Installation funktioniert. Plattformspeicher hat dies. Neotoma nicht. |
| [Semantische Ähnlichkeitssuche](https://neotoma.io/memory-guarantees#semantic-similarity-search) | Relevanten Kontext anhand der Bedeutung und nicht anhand der exakten Übereinstimmung finden. Retrieval-Systeme und Neotoma bieten dies beide mit unterschiedlichem Umfang. |
| [Direkte menschliche Bearbeitbarkeit](https://neotoma.io/memory-guarantees#direct-human-editability) | Ob Sie den Speicher in einem Standardeditor öffnen und direkt ändern können. Dies ist bei dateibasierten Systemen der Fall. Neotoma nicht. |

Jede Zeile führt zu einer speziellen Erklärungsseite mit Vorher/Nachher-Beispielen und CLI-Code. Ein Tester hatte festgestellt, dass „allgemeiner Speicher mit Schemas ungelöst ist“ und dass gängige Schemas die Antwort sein könnten. Die Garantietabelle ist meine Antwort: Hier sind die spezifischen Eigenschaften, hier ist, wo jeder Ansatz liefert, hier ist, wo er nicht funktioniert.

### Vorher und Nachher

![Screenshot: Vorher/Nachher-Abschnitt mit Antworten auf Fehler und Erfolg](/images/posts/neotoma-site-overhaul-before-after-section.png „screenshot“)

Die Intro-Animation wiederholt dieselbe Frage durch zwei Ergebnisse. Ohne Neotoma: „Kein Vertrag für Kline gefunden.“ Mit Neotoma: „Net-30, unterzeichnet am 12. Oktober, verlängert sich automatisch im ersten Quartal.“ Elf Szenarien wechseln sich ab und zeigen jeweils auf einen Blick einen echten Fehlermodus.

Unterhalb der Animation gliedern vier Fehlerkarten die Szenarien nach Datentyp: Finanzfakten, Personen und Beziehungen, Verpflichtungen und Aufgaben, Ereignisse und Entscheidungen. Jede Karte hat eine konkrete Erzählung – veraltete Kontakte, die an die falsche Person gehen, vergessene Fristen, die Erinnerungen an alte Aufgaben auslösen, widersprüchliche Aufzeichnungen, in denen zwei Agenten unterschiedliche Versionen desselben Vertrags gelesen haben und keiner wusste, dass der andere existiert.

Dies war die direkte Reaktion auf das Feedback „Vitamin vs. Schmerzmittel“. Der alte Standort führte mit Architektur. In diesem Abschnitt geht es darum, was ohne deterministischen Zustand kaputt geht und was das kostet.

### Für wen ist es?

![Screenshot: Drei Audienzkarten mit Illustrationen auf der Neotoma-Homepage](/images/posts/neotoma-site-overhaul-audience-cards.png „screenshot“)

Drei Zielgruppenkarten mit benutzerdefinierten Illustrationen: [KI-Infrastrukturingenieure](https://neotoma.io/ai-infrastructure-engineers), [Erbauer von Agentensystemen](https://neotoma.io/agentic-systems-builders) und [KI-native Einzelbetreiber](https://neotoma.io/ai-native-operators). Jeder Link führt zu einer speziellen Seite mit Fehlermodi, Datentypen und Schemamustern, die für diese Zielgruppe spezifisch sind. Dies ist die direkte Antwort auf die Frage: „Bin ich einer der Menschen, für die das gedacht ist?“

## Dokumentation

Auf der alten Website war alles inline. Tester, die Tiefe wollten, mussten zum Repo gehen. Jetzt gibt es spezielle Seiten, die in einer Seitenleistennavigation organisiert sind.

### Komplettlösung für Entwickler

![Screenshot: Entwickler-Walkthrough-Seite mit MCP-Beispielen für mehrere Sitzungen](/images/posts/neotoma-site-overhaul-developer-walkthrough.png „screenshot“)

Die [Komplettlösung für Entwickler](https://neotoma.io/developer-walkthrough) ist ein Multisitzungsszenario, das die Kernschleife durchläuft: Speichern Sie eine Architekturentscheidung in Sitzung 1, rufen Sie sie ab und reagieren Sie darauf in Sitzung 2, behandeln Sie ein widersprüchliches Update in Sitzung 3 und prüfen Sie dann den vollständigen Beobachtungspfad. Alle verwenden MCP (Model Context Protocol) und speichern Aufrufe mit echten Anfrage-/Antwortbeispielen. Dadurch wird die Frage der Aufnahme direkt beantwortet: Der Agent ruft das [MCP-Tool](https://neotoma.io/mcp) mit strukturierten Parametern auf, Neotoma speichert die Beobachtung. Keine versteckten KI-Modellaufrufe, keine Regex-Extraktion.

### Speichermodelle

![Screenshot: Seite „Speichermodelle“ mit Plattform-, Abruf-, dateibasiertem und deterministischem Speicher](/images/posts/neotoma-site-overhaul-memory-models.png „screenshot“)

Auf der Seite [Speichermodelle](https://neotoma.io/memory-models) werden vier Ansätze verglichen: [Plattformspeicher](https://neotoma.io/platform-memory), [Abrufspeicher](https://neotoma.io/retrieval-memory), [dateibasierter Speicher](https://neotoma.io/file-based-memory) und [deterministisch Speicher](https://neotoma.io/deterministic-memory). Hier stellt sich die Frage: „Sollte Neotoma mein vorhandenes Gedächtnis ersetzen oder ergänzen?“ Frage wird beantwortet. Jedes Modell verfügt über eine eigene Unterseite, auf der erklärt wird, was es ist, wo es funktioniert und wo es kaputt geht.

### Stiftungen

![Screenshot: Foundations-Seite mit datenschutzorientierten, deterministischen und plattformübergreifenden Verpflichtungen](/images/posts/neotoma-site-overhaul-foundations.png „Screenshot“)

[Foundations](https://neotoma.io/foundations) behandelt ausführlich [privacy-first](https://neotoma.io/privacy-first), deterministisch und [plattformübergreifend](https://neotoma.io/cross-platform). Die „Privacy First“-Seite reagiert auf Tester, die der Eingabe personenbezogener Daten in Cloud-KI-Tools skeptisch gegenüberstanden. Neotoma läuft auf Ihrem Computer. Ihre Daten bleiben lokal.

### Architektur

![Screenshot: Architekturseite mit dem Zustandsflussdiagramm](/images/posts/neotoma-site-overhaul-architecture-state-flow.png „screenshot“)

Die Seite [Architektur](https://neotoma.io/architecture) behandelt den Zustandsfluss (Quelle, Beobachtung, Entität, Entitäts-Snapshot), die Ebenen und wie Garantien in jeder Phase durchgesetzt werden. Dies war eine der am häufigsten nachgefragten Ergänzungen.

### Referenzseiten

Vollständige [REST-API](https://neotoma.io/api) Endpunkttabelle, [MCP-Aktionen](https://neotoma.io/mcp)-Katalog und [Befehlszeilenreferenz](https://neotoma.io/cli). Die API-Seite enthält endpunktspezifische Beschreibungen und Parameter. Die MCP-Seite listet alle 24 Aktionen auf. Die CLI-Seite deckt alle 38 Befehle ab.

## Integrationsleitfäden

Sechs werkzeugspezifische Seiten, die jeweils die Einrichtung von der Installation bis zum ersten Store durchlaufen:

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

![Screenshot: Integrationsanleitung für Neotoma mit Claude Code](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png „screenshot“)

Dies ist die direkte Antwort auf die Frage „Funktioniert es mit X?“ und „Wie richte ich das mit meinem Tool ein?“ In jedem Leitfaden geht es um die Konfiguration, ein erstes Beispiel und was Sie erwartet. Die ChatGPT-Seite ist am ausführlichsten, da die benutzerdefinierte GPT-Einrichtung die meisten Schritte umfasst. Die OpenClaw-Seite existiert, weil ein Tester ausdrücklich gefragt hat, ob sie unterstützt wird und die alte Site nicht eindeutig war.

## Anwendungsfälle

Drei spezielle Zielgruppenseiten beleuchten und erläutern nun, für wen Neotoma gedacht ist, und bieten gezielte Orientierungshilfen, die auf der alten Homepage fehlten:

![Screenshot: Zielgruppenseite für KI-Infrastrukturingenieure mit Fehlermodi und häufigen Datenmustern](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastructure.png „screenshot“)

**[KI-Infrastrukturingenieure](https://neotoma.io/ai-infrastructure-engineers).** Schwachstellen wie nicht reproduzierbare Agentenläufe, unsichtbare Zustandsänderungen und keine Herkunftsspur. Häufige Fehlermodi mit spezifischen Symbolen. Datentypen, mit denen diese Teams arbeiten (Sitzungsstatus, Pipelines, Auswertungen, Audit-Trails) und die Entitätstypen, die am häufigsten vorkommen (agent_session, Aktion, Pipeline, Auswertung).

**[Ersteller von Agentensystemen](https://neotoma.io/agentic-systems-builders).** Eine ähnliche Struktur konzentrierte sich auf Agenten-Frameworks, mehrstufige Arbeitsabläufe und Beobachtbarkeit. Fehlermodi wie stille Zustandsänderungen zwischen Sitzungen, Workflows, die nicht wiedergegeben werden können, und Kontextverlust, wenn ein Agent an einen anderen übergibt.

**[KI-native einzelne Operatoren](https://neotoma.io/ai-native-operators).** Konzentriert sich auf die tägliche Erfahrung verlorener Verpflichtungen, Tool-zu-Tool-Kontextverlust und personenbezogener Daten im undurchsichtigen Speicher des Anbieters. Dies ist die Seite für den Tester, der gefragt hat: „Bin ich einer der Leute, für die das ist?“

## Agentengeführte Installation

![Screenshot: Agent-Installationsseite mit Anweisungen zum Kopieren und Einfügen und Demo der Agent-Sitzung](/images/posts/neotoma-site-overhaul-agent-install.png „screenshot“)

Dies ist neu seit der Ankündigung der Entwicklerfreigabe. Anstatt Dokumente zu lesen und manuell zu konfigurieren, kopieren Sie eine einzelne Eingabeaufforderung von der [Installationsseite](https://neotoma.io/install), fügen sie in Ihr KI-Tool ein, und der Agent erledigt den Rest: Installation des Pakets, Ausführung von init, Konfiguration der MCP-Verbindung und Speicherung Ihrer ersten Daten.

Die Eingabeaufforderung ist für Claude Code, Codex, Cursor und OpenClaw konzipiert. Es weist den Agenten an, Neotoma mit „npm install -g neotoma“ zu installieren, zu initialisieren und dann den passenden Integrationsleitfaden für dieses Tool zu verknüpfen. Der Agent durchsucht Ihren lokalen Kontext und Plattformspeicher, zeigt eine Vorschau der gefundenen Daten an und speichert nur das, was Sie genehmigen.

Jeder Integrationsleitfaden ist mit der Installationsaufforderung verknüpft, sodass der Onboarding-Pfad unabhängig davon, mit welchem ​​Tool Sie beginnen, derselbe ist. Das Ziel besteht darin, in weniger als fünf Minuten von Null auf ein funktionierendes Neotoma-Setup mit gespeicherten echten Daten zu gelangen, ohne jemals ein Konfigurationsdokument lesen zu müssen.

## Sprachunterstützung

Die Website und alle Postinhalte werden jetzt automatisch in 12 Sprachen übersetzt: Arabisch, Bengali, Katalanisch, Französisch, Deutsch, Hindi, Indonesisch, Mandarin-Chinesisch, Portugiesisch, Russisch, Spanisch und Urdu. Jede Seite enthält einen Sprachumschalter und RTL-Layouts funktionieren für Arabisch und Urdu.

Dies ist wichtig, da die Entwicklerversion Tester außerhalb der englischsprachigen Märkte erreicht hat. Anstatt die Dokumentation hinter einer einzigen Sprache zu verbergen, ist jede Seite – die Startseite, Speichergarantien, Integrationshandbücher, Anwendungsfallseiten und Beiträge – in allen 12 Gebietsschemas verfügbar. Die Übersetzungen werden automatisch generiert und sind möglicherweise nicht perfekt, aber sie verringern die Hürde für jeden, der Neotoma in seiner Hauptsprache bewertet.

## Was kommt als nächstes?

Durch die Überarbeitung der Website werden die Präsentations- und Dokumentationslücken behoben. Die nächste Arbeitsrunde befasst sich mit den Produktlücken, die die Tester entdeckt haben.

- **Agentgesteuertes Onboarding.** Der aktuelle Installationsablauf dient der Einrichtung, ist jedoch passiv. Sie installieren, initiieren und beginnen mit dem Speichern. Die nächste Version wird eine geführte Entdeckungserfahrung sein, bei der Ihr Agent Ihre lokalen Dateien scannt, die Kandidaten mit dem höchsten Wert vorschlägt und innerhalb der ersten Minuten einen Zeitplan aus Ihren eigenen Daten rekonstruiert. Das Ziel ist ein konkreter Moment, in dem Sie sehen, wie Ihre verstreuten Projektdateien in eine strukturierte Zeitleiste umgewandelt werden, in der jedes Ereignis einer bestimmten Quelle zugeordnet wird. In diesem Moment wird der Unterschied zwischen Neotoma und einem Chat-Speicher offensichtlich.

- **Export von Markdown-Datensätzen.** Mehrere Entwickler, insbesondere diejenigen von Claude Code, erwarten, dass der Speicher als Markdown-Dateien dargestellt wird, die sie direkt durchsuchen und bearbeiten können. Neotoma verwendet SQLite als kanonischen Speicher, was Ihnen deterministische Abfragen und Schemaeinschränkungen ermöglicht, aber bedeutet, dass Sie eine Datei nicht einfach in Ihrem Editor öffnen können. Ich füge einen Befehl hinzu, um Ihre Datensätze als Markdown-Dateien auf der Festplatte zu exportieren, organisiert nach Entitätstyp, mit Frontmatter-Metadaten und Herkunft. SQLite bleibt kanonisch. Die Markdown-Dateien sind ein lesefreundlicher Spiegel für Transparenz und Einsehbarkeit.

- **Leichterer Remote-Zugriff für ChatGPT und Claude.** Die Integrationshandbücher sind jetzt vorhanden, aber die Remote-Setup-Pfade für ChatGPT (benutzerdefiniertes GPT mit API-Endpunkt) und Claude (Desktop mit Remote-MCP) erfordern mehr eigenes Dogfooding und Debuggen, bevor sie so reibungslos funktionieren wie die lokalen Pfade für Cursor und Claude Code. Ich möchte, dass beides durchgängig zuverlässig funktioniert und die Anleitungen mit klareren Anweisungen und Fehlerbehebungen aktualisiert werden.

## Worüber ich Feedback möchte

Die Entwicklerversion ist noch aktiv. Wenn Sie versuchen, Neotoma zu installieren und die Site durchzuarbeiten, möchte ich Folgendes wissen:

- Ist die Positionierung klar? Wenn Sie auf der Startseite landen, verstehen Sie dann, was Neotoma macht und wie es sich von dem unterscheidet, was Sie bereits verwenden?
- Hilft Ihnen die Tabelle der Speichergarantien bei der Entscheidung, ob Neotoma für Ihren Arbeitsablauf relevant ist?
- Ist der Installations- und Onboarding-Pfad klar? Können Sie von der Baustelle zu einer funktionierenden Einrichtung gelangen, ohne gegen eine Wand zu stoßen?
- Sind die Integrationsleitfäden für Ihr Tool korrekt?

Besuchen Sie [neotoma.io](https://neotoma.io), bitten Sie Ihren Agenten, mit den Anweisungen zum Kopieren und Einfügen zu [installieren](https://neotoma.io/install) und teilen Sie uns Ihr Feedback mit. Öffnen Sie ein Problem auf [GitHub](https://github.com/markmhendrickson/neotoma) oder wenden Sie sich direkt an uns.