AgentWorkingMemory: Ein lokales Speichersystem für KI-Codierungsagenten

Was AgentWorkingMemory löst

KI-Codierungsagenten wie Claude Code verfügen nicht über persistenten Speicher zwischen Sitzungen. Entwickler müssen jedes Mal, wenn sie eine neue Sitzung starten, Architektur, Datenbankschemata und frühere Entscheidungen erneut erklären, was Zeit und Kontextfensterplatz verschwendet. Obwohl Claude Code einige Tools wie --continue zum Fortsetzen von Gesprächen, automatischen Speicher, der Notizen in Markdown-Dateien speichert, und CLAUDE.md-Projektdokumentation bietet, haben diese Einschränkungen:

• --continue oder --resume stellen gesamte Chat-Threads wieder her, verbrauchen aber Kontextfensterplatz und funktionieren nur mit einem Thread gleichzeitig
• Automatischer Speicher lädt die ersten 200 Zeilen von MEMORY.md, hat aber keine intelligente Abruflogik – er weiß nicht, welche Notizen für die aktuelle Arbeit relevant sind
• Projektdokumentation wie CLAUDE.md funktioniert für stabile Informationen, wird aber in schnelllebigen Projekten schnell veraltet

AgentWorkingMemory adressiert diese Probleme, indem es Wissen über Sitzungen hinweg sammelt, relevante Kontexte für die aktuelle Arbeit bereitstellt und sich ohne manuelle Verwaltung im Laufe der Zeit verbessert.

Wie es funktioniert

AWM läuft vollständig lokal auf Ihrem Rechner ohne Cloud-Abhängigkeiten. Das System besteht aus:

• Einer SQLite-Datenbank für die Speicherung
• Drei lokalen ML-Modellen (insgesamt ~124 MB, einmal heruntergeladen und zwischengespeichert)
• Einem Node.js-Prozess

Es gibt keinen Server, keinen Docker-Container und keinen Hintergrunddienst. Wenn Sie Claude Code starten, wird AWM automatisch über MCP (Model Context Protocol) gestartet. Wenn Sie die Sitzung schließen, wird es beendet. Alles bleibt lokal – keine Cloud, keine API-Schlüssel, keine Daten verlassen Ihren Rechner. Für zusätzliche Sicherheit unterstützt AWM Bearer-Token-Authentifizierung, um den Zugriff auf die Speicher-API zu sperren.

Einrichtung und Nutzung

Die Installation erfordert zwei Befehle:

npm install -g agent-working-memory
awm setup --global

Nach dem Neustart von Claude Code erscheinen automatisch 14 Speichertools. Die erste Sitzung dauert etwa 30 Sekunden, während die ML-Modelle heruntergeladen werden (~124 MB, danach zwischengespeichert). Ab diesem Zeitpunkt:

• Der Agent schreibt Erinnerungen, wenn er etwas Wichtiges lernt
• Er ruft relevante Erinnerungen ab, wenn er neue Arbeit beginnt
• Er sichert seinen Zustand, um nach Unterbrechungen wiederherzustellen

Das System wurde während der Modernisierung einer 20 Jahre alten Codebasis (~1,4 Millionen Zeilen) in einen modernen Stack (~250.000 Zeilen geschätzt) entwickelt, speziell für eine Mitgliederverwaltungsplattform mit 88 Datenbanktabellen und Multi-Sprint-Entwicklung unter Verwendung mehrerer KI-Agenten parallel.