memora: versionskontrollierter, typisierter Speicher für KI-Agenten – Git für KI-Überzeugungen

memora ist ein CLI-Tool, das den Speicher von KI-Agenten versioniert – typisiert, mit Herkunftsnachweis, verzweigbar und zusammenführbar. Denken Sie an Git für das, was die KI über Ihre Codebasis glaubt, nicht für Dateiänderungen. Das gesamte Projekt umfasst ~5.000 Zeilen Rust in zwei Crates und produziert eine einzelne statische Binärdatei ohne externe Abhängigkeiten (SQLite über rusqlite eingebunden). Läuft auf allen drei Hauptplattformen mit CI.

Crate-Struktur

• memora-core – Bibliothek ohne CLI-Abhängigkeiten. Typen, SQLite-Speicher, Snapshot-Engine, 3-Wege-Merge, Sitzungsaufzeichnung, Export-Adapter.
• memora-cli – dünne auf clap basierende CLI-Schicht darüber.

Technische Highlights

• Clock-Trait für deterministische Tests – keine flaky Timestamps.
• Inhaltsadressierte IDs mittels SHA-256 kanonischer Formstrings.
• 3-Wege-Merge mit BFS-Merge-Base-Erkennung über den gesamten Eltern-DAG.
• node_versions-Tabelle, die den vollständigen Knotenstatus pro Commit snapshot – ermöglicht Diff, Rollback und reversible GC.

Design-Entscheidungen & offene Fragen

Der Autor bittet um Feedback zu mehreren Bereichen:

• Wichtigkeitsbewertungsformel für GC und Export-Ranking.
• Ob der MemorySource-Enum offen sein sollte (hat derzeit einen Unknown(String)-Varianten).
• Remote-Synchronisationsmodell – derzeit nur dateisystembasiert; die copy_commits_between-Grenzfläche ist der Punkt, an dem Netzwerktransport eingesteckt werden könnte.

Repository: github.com/harshtripathi272/memora – MIT-lizenziert.