toon-memoryBereitgestellt von TOON
Die Kontinuitätsschicht für KI-Agenten
Das Wissen deines Agents überlebt jede Sitzung — offline, privat, ohne LLM.
$npm install -g toon-memory
Warum verlieren Agenten Kontext zwischen Sitzungen?
KI-Coding-Agenten starten jede Sitzung mit Gedächtnisverlust
Kontext wird täglich zurückgesetzt
Bei jeder neuen Sitzung vergisst dein Agent die Entscheidungen, Muster und Bugs, die er gelernt hat. Du erklärst denselben Kontext immer und immer wieder.
In der Geschichte stöbern
Ohne Speicher durchsuchen Agenten den Git-Verlauf und lesen Dateien neu, um zu rekonstruieren, warum etwas auf eine bestimmte Weise gebaut wurde — und verbrennen Token und Zeit.
Copy-Paste-Notizen
Entwickler fügen Kontext manuell zwischen Chats ein. Es ist zerbrechlich, veraltet und erreicht nie den nächsten autonomen Lauf.
toon-memory gibt deinem Agenten einen persistenten, abfragbaren Speicher — sodass Kontext automatisch jede Sitzung überlebt.
Lerne toon-memory kennen
Die Kontinuitätsebene für deinen Workflow
Während ein Speicher Fakten ablegt, bewahrt eine Kontinuitätsebene, wie dein Projekt funktioniert — damit jede Sitzung dort beginnt, wo die letzte endete.
Entscheidungen
Das "Warum" hinter jeder Wahl — Frameworks, Bibliotheken, Kompromisse. Abgerufen, wenn es zählt, nie neu aufgerollt.
Konventionen
Namens-, Struktur- und Stilregeln, auf die sich dein Team geeinigt hat. Befolgt, ohne erneut gesagt zu werden.
Kontext
Architektur-, Umgebungs- und Betriebswissen, das in keiner einzelnen Datei lebt.
Geteiltes Verständnis
Projektwissen und Team-Entscheidungen, verfügbar für jeden Agenten und jede Sitzung.
toon-memory führt das Konzept einer Kontinuitätsebene ein: ein leichtes System, das Projektwissen, Entscheidungen und Kontext zwischen KI-Sitzungen bewahrt — ohne Cloud-Dienste und schwere Infrastruktur.
Warum Entwickler toon-memory wählen
Privat, leichtgewichtig, universell
Die Garantien, die Projekterinnerung sicher machen.
Datenschutz zuerst
- 100% lokal — kein Cloud, kein Server, keine Telemetrie
- Optionale AES-256-GCM-Verschlüsselung
- Du besitzt die Speicherdatei wie jede Quelldatei
Leichtgewichtig
- Natives TOON-Format — 22% weniger Tokens als JSON
- Keine Abhängigkeiten, läuft auf jedem Node.js 18+
- Deterministische Logik — keine LLM-Aufrufe, keine API-Schlüssel
Universell
- Funktioniert mit 15+ Agenten: Claude Code, Codex, Gemini CLI, Cursor, OpenCode und mehr
- Standard-MCP — Agenten wechseln, ohne Kontext zu verlieren
- Projektweiter Speicher, den jedes Teammitglied teilt
Gleiches Projekt. Zwei Sitzungen.
Was dein Agent sich merkt, ändert das Ergebnis.
Benchmarks
Gemessen, nicht angenommen
Token- und Tool-Call-Ersparnis, gemessen in einer realen Sitzung
weniger Tokens
weniger Tool-Calls
weniger Tokens
weniger Tokens
weniger Tokens
Das TOON-Format ist für LLMs gebaut, nicht für Menschen
JSON 1097→TOON 850
Gemessen mit gpt-tokenizer (cl100k_base) über 16 repräsentative Speicher-Einträge, vergleicht das echte TOON-Format auf Disk mit kompaktem JSON. Reproduzierbar: npm run bench.
LongMemEval-artige Suche über einen eingefrorenen 187-Einträge-Snapshot — 42 Gold-Queries
Echter data.toon-Snapshot (187 Einträge, 2026-08-01), deterministisches today, schreibgeschützt, keine Kopien; 2 Priority-Meta-Einträge ausgeschlossen. Reproduzierbar: npm run bench:retrieval.
Auto-Loading: Das OpenCode-Plugin injiziert nur dateirelevante Erinnerungen statt alle Einträge zu laden. Volle Sitzung: Start → Debug → Implementierung → Review → Abschluss. Reproduzierbar: npm run bench:full, npm run bench:primer, npm run bench:compress-all.
Wie funktioniert das?
Vier Schritte von Gedächtnisverlust zu Speicher
Installieren
Ein Befehl. Null Konfiguration für 15+ Agenten.
npm install -g toon-memoryMerken
Speichere Entscheidungen, Muster und Bugs während der Arbeit — mit automatischer Tag-Inferenz und optionalem TTL.
memory_remember({
category: "decision",
key: "use-zod",
content: "Use Zod for validation",
file: "src/types.ts"
})Abrufen
Dein Agent fragt den Speicher bei Bedarf ab — keine Neuerklärung, kein Token-Verschwendung.
memory_recall({ query: "validation" })
// [decision] use-zod (a1b2c3d4)
// Use Zod for validation — src/types.tsKontext
Ein Aufruf gibt deinem Agenten alles: Projekt, Git, Speicher, Sitzungen. 80% weniger Tool-Aufrufe.
context_generate({})
// # Project Briefing (full)
// ## Project — toon-memory v4.3.0
// ## Git — branch: main, 3 commits
// ## Memory — 26 entries, 18 edges
// ## Sessions — 2 activeEin Speicher-Toolkit, kein Protokoll
Alles, was dein Agent zum Merken, Abrufen und Denken braucht — nach Zweck gruppiert, mit Ressourcen für direktes Kontext-Lesen und einem interaktiven Graph-Viewer.
memory_remembermemory_recallmemory_forgetmemory_statsmemory_diffmemory_suggestmemory_summarymemory_archivememory_checkpointmemory_visualizememory_pinmemory_unpinmemory_tagmemory_reflectmemory_promotememory_smart_recallmemory_capturedmemory_consolidatememory_graph_pathmemory_searchcontext_briefcontext_generatecontext_diffcontext_focuscontext_healthcontext_exportmemory_compressmemory_primermemory_sessionsmemory_merge_sessionsmemory_export_gistmemory_import_gistmemory_encryptmemory_decryptmemory_backupMulti-Agent
Funktioniert mit allen großen KI-Coding-Agenten. OpenCode, VS Code, Claude, Cursor, Windsurf, Cline, Continue — Null Konfiguration.
TOON-Format
22% weniger Token als JSON (gemessen). Benutzerdefinierte Kodierung für LLM-Verständnis und Token-Effizienz.
Smart Recall
Graph-basierter Recall, neu sortiert nach BM25-Relevanz und Graph-Zentralität (Hubs tauchen auch ohne Suchwort auf). Hop-Weiser Decay hält fernen Kontext niedrig. Token-effizienter `compact`-Modus gibt numerisch indexierte, snippet-abgeschnittene Ergebnisse zurück.
Intelligenter Speicher
Automatische Tag-Inferenz aus integriertem Vokabular plus Projekt-Abhängigkeiten, Qualitäts-Bewertung, Konfidenz-Scores, Merge-Dedup, verwandte Eintrags-Vorschläge, Speicher-Diff und konfigurierbare TTL für temporären Kontext.
Verschlüsselung
AES-256-GCM für sensible Daten. Automatisches Archiv alter Einträge. Watch-Modus für automatische Sicherung alle N Minuten.
Dein Speicher als Graph
Verbinde Entscheidungen mit Specs, Bugs und Architektur. Recall gibt den richtigen Kontext zurück — nicht nur Übereinstimmung.
- Verbinde Einträge mit `links` oder `[[key]]`-Referenzen — keine Embeddings, kein LLM
- `memory_recall({ mode: "graph" })` erweitert einen beziehungsbewussten Subgraphen
memory_recall({ query: "riesgo", mode: "graph" })
[decision] risk-engine-priority (a1b2c3d4)
The engine prioritizes risk over speed.
File: spec.md:10 | Tags: risk;spec | Date: 2026-07-01
links: engine-archmemory_recall({ query: "riesgo", mode: "graph", compact: true })
[1] decision/risk-engine-priority
The engine prioritizes risk over speed.
tags: risk;spec · edges: ->2, ->3Memory-Graph-Viewer
Visualisiere dein Gedächtnis als interaktiven kraftgerichteten Graphen. Sieh Einträge, Verbindungen, Kategorien und Zugriffsmuster auf einen Blick.
- CLI-Viewer:
npx toon-memory viewerstartet einen HTTP-Server - Inline MCP-Apps-Viewer: rufe
memory_visualize()auf, um den Graphen direkt in MCP-Apps-kompatiblen Hosts zu rendern — ohne Server - Hover über Knoten zeigt Tooltips mit Inhaltsvorschau und Qualitätspunktzahl
- Klicken zum Auswählen und Zentrieren; Doppelklick öffnet Details
- Suche filtert Einträge und hebt passende Knoten mit pulsierendem Glühen hervor
- Pfadfinder findet und hebt die kürzeste Verbindung zwischen zwei Einträgen hervor
- Einstellbare Physik, dunkles/helles Thema, PNG/SVG-Export
Ein Speicher-Toolkit
Alles, was dein Agent zum Merken, Abrufen und Denken braucht
Kernspeicher
memory_rememberIm Speicher speichern
Speichere Entscheidungen, Muster, Bugs, Wissen oder warnings (negative „Tu das NICHT"-Erinnerungen, mit Boost abgerufen) — persistiert über Sitzungen mit automatischer Qualitätsbewertung.
memory_recallSpeicher durchsuchen
Befrage den Wissensgraph vor dem Datei-Lesen. Qualitätsgewichtete Ergebnisse. Unterstützt path_scope und Budget-Steuerung (tiny/normal/deep). explain: true fügt eine Begründungszeile pro Eintrag hinzu; budget_tokens begrenzt die Ausgabe nach geschätzten Token.
memory_statsSpeicher-Statistiken
Zeigt Statistiken über den Projekt-Speicher inklusive Qualitätsverteilung, meistbesuchte Einträge und Hit-Rate-/Duplikat-/Veraltet-Metriken.
Suche & Intelligenz
memory_smart_recallSmart Recall
Einheitliche Suche kombiniert BM25 + Graph-Zentralität + Qualität + Frische in einem Aufruf. Unterstützt explain: true (Begründungen pro Eintrag) und budget_tokens (Ausgabe-Limit).
memory_consolidateKonsolidieren
Führt doppelte Einträge mit identischem Inhalt deterministisch zusammen, erkennt Near-Duplicates über Jaccard-Ähnlichkeit (>50%), entfernt Einträge niedriger Qualität im Batch oder mustert Einträge älterer Bibliotheksversionen aus (mode: "versions") — über den mode-Parameter, ohne LLM.
Kontext-Briefing
context_generateVollständiges Projektbriefing
Ein-Aufruf-Briefing: Projektstruktur + Git-Zustand + Speicher + Sitzungen. Ersetzt 6 manuelle Aufrufe. Spart 93% Token.
context_healthGesundheits-Audit
Verwaiste Links, Duplikate, defekte Dateiverweise, abgelaufene TTL, veraltete Sitzungen. Score 0–100.
Komprimierung
memory_compressLLM-Komprimierung
LLM-gestützte Zwei-Schritt-Komprimierung: Zusammenfassen + Überschreiben. Verwendet Anthropic/OpenAI CLI wenn verfügbar.
memory_primerKontext-Primer
Ein-Aufruf-Kontext-Primer: Top-Speicher + Kategorien + Sitzungsdatei-Änderungen. Wird automatisch zu Sitzungsbeginn injiziert.
Sitzungen
memory_sessionsSitzungen
Zeigt aktive Agenten-Sitzungen und erkennt weiche Konflikte.
memory_merge_sessionsSitzungen zusammenführen
Führt Beobachtungen über parallele Sitzungen für eine Datei zusammen. Dedupliziert und befördert automatisch.
Sync & Sicherheit
memory_encryptVerschlüsselung aktivieren
AES-256-GCM-Verschlüsselung mit automatisch generiertem Schlüssel.
memory_backupSpeicher sichern
Erstellt einen zeitgestempelten Backup der Speicherdatei. Automatisch auf die 10 neuesten gekürzt.
memory-entriesmemory-statsmemory-summariesmemory-viewer (ui://viewer)Funktioniert mit 15+ KI-Coding-Agenten
Null Konfiguration — toon-memory erkennt und konfiguriert jeden automatisch
OpenCode
VS Code / Copilot
Claude
Cursor
Windsurf
Cline
Continue
Codex
Gemini
Zed
Antigravity
Aider
KiloCode
OpenClaw
KiroHäufig gestellte Fragen
Alles, was du wissen musst, um deinem Agenten einen Speicher zu geben
Was ist toon-memory?
Eine persistente Speicherschicht für KI-Coding-Agenten mit 35 MCP-Tools. Es speichert Entscheidungen, Muster, Bugs und Kontext in einem kompakten TOON-Format, damit dein Agent sich an alles zwischen Sitzungen erinnert — mit 80% weniger Tool-Aufrufen pro Sitzung.
Welche Agenten werden unterstützt?
OpenCode, VS Code, Claude Code, Cursor, Windsurf, Cline, Continue, Codex, Gemini, Zed, Antigravity, Aider, KiloCode, OpenClaw und Kiro — 15+ Agenten mit Null Konfiguration über den MCP-Server.
Wie werden meine Daten gespeichert?
Einträge werden in eine lokale TOON-Datei geschrieben (ein token-effizientes Format, ~22% kleiner als JSON, gemessen). Du besitzt die Datei und kannst sie committen, diffen oder sichern wie jede andere Quelldatei.
Ist mein Speicher verschlüsselt?
Ja. Aktiviere Verschlüsselung mit dem memory_encrypt-Tool, um sensible Einträge mit AES-256-GCM zu sichern. Der Schlüssel wird automatisch generiert und lokal gehalten.
Funktioniert es offline?
Völlig. toon-memory läuft lokal ohne externe Dienste oder Konten. Watch-Modus erstellt sogar automatische Sicherungen nach Zeitplan.
Können mehrere Agenten denselben Speicher teilen?
Ja. Da der Speicher in einer normalen Datei in deinem Projekt lebt, lesen und schreiben alle für dieses Projekt konfigurierten Agenten denselben Kontext.
Wie sichere ich meinen Speicher?
Verwende den Watch-Modus für geplante automatische Sicherungen oder committe einfach die TOON-Datei in Git. Alte Einträge werden nach 30 Tagen automatisch archiviert.
Ist es frei und Open Source?
Ja. toon-memory ist MIT-lizenziert und kostenlos nutzbar. Der Quellcode ist auf GitHub und das Paket wird auf npm veröffentlicht.
Wie unterscheidet es sich vom eingebauten Speicher meines Agenten?
Eingebauter Speicher ist oft flüchtig oder anbieterspezifisch. toon-memory gibt dir eine portable, diffbare, verschlüsselte Speicherdatei, die du vollständig kontrollierst — über Agenten und Projekte hinweg.
Kann ich temporären Kontext ablaufen lassen?
Ja. Setze ein TTL (z.B. ttl: "7d") auf einen Eintrag und er läuft automatisch ab — perfekt für Sprints, Deadlines und zeitkritische Notizen.
Was ist Smart Recall?
memory_smart_recall kombiniert BM25-Suche, Graph-Zentralität, Qualitätsbewertung und Frische-Decay in einem Aufruf — das Beste aller Ranking-Strategien ohne manuelle Orchestrierung.
Wie funktioniert die Qualitätsbewertung?
Jeder Eintrag erhält automatisch einen Qualitäts-Score (0-1) basierend auf Tag-Abdeckung, Link-Reichtum, Inhaltsdetail, Frische und Spezifität. Hochwertige Einträge tauchen zuerst in Recall-Ergebnissen auf.
Was passiert, wenn ich denselben Key zweimal speichere?
Das System vermergt Attribute statt zu ersetzen: Tags und Links werden vereint, Qualität und Konfidenz nehmen den Maximalwert, und das Datum wird aktualisiert. Dein Eintrag wird im Laufe der Zeit reicher.
Was ist Speicherkomprimierung?
memory_compress lässt ein LLM verwandte Einträge zu einer knappen Zusammenfassung verdichten. memory_consolidate(mode: "low-quality") entfernt Einträge niedriger Qualität (kein Tags, kurzer Inhalt) deterministisch — kein LLM nötig. Beide reduzieren die Token-Anzahl.
Kann ich Speicher zwischen Maschinen synchronisieren?
Ja. Verwenden Sie memory_export_gist, um Einträge an einen GitHub Gist zu senden, dann memory_import_gist auf einer anderen Maschine. Einträge werden automatisch fusioniert (Vereinigung von Tags, maximale Konfidenz).
Bereit, deinem Agenten Kontinuität zu geben?
In Sekunden installiert — erkläre dein Projekt nie wieder.