KI-Entwicklung ohne Gedächtnisverlust: ContextVault sichert Kontext für Agenten

Ein altes Projekt neu aufgerollt zu haben, sollte eigentlich Routine sein. Doch als ein Entwickler kürzlich einen Codebaustein für die Benutzerauthentifizierung wiederentdeckte, fehlte etwas Entscheidendes: der Kontext.

Die Git-Commits zeigten zwar den finalen Stand der Implementierung. Doch warum bestimmte Lösungswege gewählt wurden, welche Fehler bereits behoben oder noch offen waren – all das war nirgends dokumentiert. Die Antworten versteckten sich in verstreuten Chat-Protokollen von ChatGPT, Sitzungen mit Codex oder nicht mehr existierenden Terminal-Sitzungen.

Noch komplexer wurde die Situation durch den häufigen Wechsel zwischen verschiedenen KI-Entwicklungstools. Mal fehlten Credits, mal erwies sich ein Werkzeug als ungeeignet für die jeweilige Aufgabe. Jedes Mal begann der neue Agent von vorne – ohne Kenntnis dessen, was der Vorgänger bereits getestet, verworfen oder empfohlen hatte. Entweder musste der Entwickler mühsam alles neu erklären, oder der Agent musste wertvolle Zeit mit der Wiederholung bereits gescheiterter Ansätze verbringen.

Diese Erfahrung führte zur Entstehung von ContextVault – einer Open-Source-Lösung, die als lokale Gedächtnisschicht für KI-gestützte Entwicklungsprozesse dient.

Warum ContextVault entwickelt wurde: Das Problem mit fragmentiertem KI-Kontext

ContextVault löst ein zentrales Dilemma in der modernen Softwareentwicklung: KI-Tools wie Codex, Claude Code oder Cursor arbeiten isoliert voneinander. Jeder Agent startet mit einem leeren Arbeitsspeicher, selbst wenn derselbe Entwickler oder dasselbe Projekt bereits Stunden oder Tage zuvor bearbeitet wurde.

Während Git die Änderungen am Code dokumentiert, fehlt eine systematische Erfassung der Entscheidungsgründe, verworfenen Ansätze und offenen Aufgaben. Genau diese Lücken versucht ContextVault zu schließen – mit einem Fokus auf lokale Speicherung und einfache Wiederverwendung.

Die Lösung besteht aus drei Hauptkomponenten:

• Browser Capture: Eine Chrome-Erweiterung, die Gespräche mit unterstützten LLMs lokal speichert und als Markdown oder ZIP exportieren kann.
• Vault Terminal: Ein npm-basiertes CLI, das die Arbeit von Agenten, Entscheidungen, Aufgaben und Notizen innerhalb eines Projekts aufzeichnet.
• ContextVault Desktop: Eine grafische Oberfläche zum Durchsuchen, Abrufen und Vorbereiten von Projektkontext für spätere Sessions.

Ein entscheidender Vorteil: ContextVault kommt ohne Cloud-Backend aus. Alle Daten bleiben lokal – entweder im Browser, in Markdown-Dateien oder in einem Projektverzeichnis.

Ein Praxisbeispiel: Wie ContextVault die Entwicklungsarbeit verändert

Stellen Sie sich vor, ein Entwickler arbeitet an einer Authentifizierungs-Implementierung. Während der Session mit einem KI-Agenten entstehen folgende Einträge:

npx @aliabdm/contextvault init contextvault record

In der laufenden Session werden nur die relevanten Informationen festgehalten:

• /title: Fix authentication callback
• /source: codex
• /user: The login redirects back to the sign-in page.
• /agent: The session cookie is missing during the callback.
• /decision: Keep authentication checks in middleware.
• /problem: The previous SameSite change did not fix the callback.
• /task: Add a regression test for the redirect loop.
• /end

Diese Einträge werden als lesbare Markdown-Dateien im Verzeichnis .contextvault/sessions/ abgelegt. Später kann ein Entwickler oder ein neuer Agent gezielt nach diesen Informationen fragen:

contextvault history --since 2w
contextvault decisions auth --source codex
contextvault problems auth --since 30d
contextvault retrieve "authentication callback"
contextvault prepare "fix authentication callback"

Die Befehle retrieve und prepare ermöglichen es, relevante Ereignisse zu finden oder sogar ein gebündeltes Dokument für den nächsten Agenten zu erstellen. Wichtig: ContextVault nutzt eine deterministische, lexikalische Suchmaschine – es werden keine Daten an LLMs gesendet oder ungesicherte Antworten generiert.

Vom CLI zur Desktop-Oberfläche: Warum eine grafische Oberfläche notwendig war

Die erste Version von ContextVault bestand ausschließlich aus dem CLI-Tool. Zwar funktionierte das Konzept, doch die Zielgruppe blieb begrenzt. Entwickler, die lediglich nach „Authentifizierungsentscheidungen der letzten 30 Tage“ suchten, sollten nicht gezwungen sein, sich mit komplexen Befehlssyntaxen auseinanderzusetzen.

Die Herausforderung bestand darin, eine grafische Oberfläche zu schaffen, die den Kern des Tools erhält, aber gleichzeitig die Benutzerfreundlichkeit erhöht. Inspiriert von Tools wie Docker CLI und Docker Desktop wurde eine Architektur gewählt, die beide Welten verbindet:

• Gleiche Engine und Datenmodell: Sowohl CLI als auch Desktop greifen auf dieselbe Codebasis und dieselben Markdown-Dateien zu.
• Getrennte Benutzeroberflächen: CLI bleibt für Entwickler relevant, die in Terminals arbeiten, während Desktop eine intuitive Navigation ermöglicht.

Ein kritischer Fehler, den viele Entwickler machen würden, wäre gewesen, zwei separate Implementierungen zu erstellen – eine für die Kommandozeile und eine für die Desktop-Oberfläche. Das hätte zu Dateninkonsistenzen, doppelter Wartung und Migrationen geführt.

Stattdessen nutzt ContextVault eine single source of truth: Alle Einträge werden in Markdown-Dateien gespeichert und von einer lokalen Suchmaschine verarbeitet. Die Desktop-Oberfläche ist lediglich eine grafische Hülle über diesem System.

Wie die Desktop-App Kontext in Echtzeit verarbeitet

Wenn ein Entwickler in der Desktop-App auf „Aufzeichnung starten“ klickt, startet der Hintergrundprozess einen eingebetteten Rekorder für das ausgewählte Projekt. Die Benutzeroberfläche kommuniziert mit diesem Rekorder über eine schmale API:

startRecorder({ title, source })
sendRecorderCommand(recorderId, command)
finishRecorder(recorderId)
cancelRecorder(recorderId)

Jeder Eintrag, der in der GUI erstellt wird, wird direkt an den Rekorder gesendet und als Markdown-Datei gespeichert. Das bedeutet:

• Eine Session, die in der Desktop-App beginnt, ist sofort über das CLI sichtbar:

  contextvault list
  contextvault show <session-id>

• Keine Konvertierung oder manuelle Synchronisation ist nötig.

Zusätzlich überwacht die Desktop-App aktiv das Projektverzeichnis. Jede Änderung in den .contextvault/sessions/ wird sofort erfasst und in die lokale Suchindexierung übernommen. So bleibt der Kontext immer aktuell – unabhängig davon, ob er über das Terminal, den Browser oder die grafische Oberfläche hinzugefügt wurde.

Die Zukunft von ContextVault: Semantische Suche und agentenübergreifende Zusammenarbeit

ContextVault befindet sich noch in der frühen Phase, doch die Vision geht weiter: Es soll nicht nur der Kontext innerhalb eines Projekts gesichert werden, sondern auch die Zusammenarbeit zwischen verschiedenen KI-Agenten erleichtern.

Mögliche Erweiterungen umfassen:

• Semantische Suchfunktionen, die nicht nur Stichworte, sondern auch die Bedeutung von Entscheidungen erkennen.
• Integration in IDEs wie VS Code, um Kontext direkt während der Entwicklung abzurufen.
• Teamfunktionen, die es mehreren Entwicklern ermöglichen, gemeinsam an einem Projektkontext zu arbeiten – ohne dass Daten in der Cloud gespeichert werden müssen.

Die größte Stärke von ContextVault liegt darin, dass es den Entwicklungsprozess nicht verlangsamt, sondern beschleunigt – indem es verhindert, dass wertvolle Zeit mit der Wiederholung bereits bekannter Fehler oder Entscheidungen verschwendet wird. In einer Welt, in der KI-Tools immer mächtiger werden, aber oft isoliert voneinander agieren, könnte ContextVault zum unverzichtbaren Gedächtnis für nachhaltige Softwareentwicklung werden.