mem0ry4ai

Memorie persistenta, local-first, pentru agenti de cod. Asistentul tau AI isi aminteste in sfarsit proiectele intre sesiuni.

Ia-l de pe GitHub Ultimul release

Python stdlib + PHP 8 · fara Docker, fara baza vectoriala, fara chei API · GPL-2.0

Ce este mem0ry4ai?

Agentii de cod ca Claude Code uita totul intre sesiuni — fiecare capcana pe care ati depanat-o impreuna, fiecare decizie luata, fiecare „unde am ramas?" cand revii la un proiect dupa o luna. mem0ry4ai rezolva asta: stocheaza cunostintele durabile (capcane, decizii, fapte, comenzi, preferinte, todos, status de proiect) in markdown simplu versionat cu git si injecteaza automat felia relevanta la inceputul fiecarei sesiuni — scoped pe proiectul in care lucrezi.

Am studiat intai peisajul existent (claude-mem, basic-memory, mem0, Letta/MemGPT, Graphiti, serverul oficial MCP de memorie) si am proiectat impotriva esecurilor recurente: modele care uita sa cheme tool-urile de salvare, baze vectoriale fragile, memorie care putrezeste silentios si auto-extractie supra-increzatoare.

Functionalitati

Markdown + git = sursa de adevarAuditabil, diffabil, editabil de mana. Indexul SQLite FTS5 e derivat si regenerabil — il stergi si se reface.
Hooks deterministe de sesiuneHook-urile Claude Code injecteaza memoriile relevante la SessionStart — nu te bazezi pe model sa-si aminteasca sa le ceara.
Supersedare, nu stergereFaptele invechite se marcheaza superseded, cu link la inlocuitor. Istoria ramane; git pastreaza tot.
Captura cu gate de incredereAgentul cu context complet scrie direct; extractia optionala cu LLM local (Ollama) trece printr-o coada de review umana — am masurat modelele mici la confidence ~1.0 la orice.
„Unde am ramas?" din constructieTipuri dedicate todo si status, afisate primele la injectare si pe pagina fiecarui proiect.
Cautare rankedFTS5 (bm25) din CLI si din web UI — acelasi index, fara embeddings la scara personala.
Web UI cu live updatesDashboard de sistem cu health checks, pagini per proiect, operatii bulk, navigare pe lantul de supersedare, coada de review. Bilingv EN/RO.
„Ce vede Claude"Pagina de transparenta care randeaza exact injectarea primita de agent, cu marimea in bytes si tokens.
Zero dependinte grelePython stdlib + PHP 8 + git. Web UI-ul ruleaza pe un launcher php -S, pornit automat de hook-ul de sesiune.

Impact masurat

Cifre reale din monorepo-ul autorului (30 de sub-proiecte, 217 memorii active) — inainte si dupa migrarea unui CLAUDE.md monolitic in mem0ry4ai:

Inainte: 242.956 bytes (1.832 linii) de context incarcat la fiecare pornire de sesiune ≈ ~61k tokens.
Dupa: ~29KB din radacina repo-ului (≈ ~7,3k tokens) sau ~19KB dintr-un sub-proiect (≈ ~4,8k tokens) — o reducere de 88–92%, scoped pe ce e relevant.
Overhead: hook-ul de SessionStart costa 69 ms; poll-ul de live-update costa 1–4 ms cand nu s-a schimbat nimic.
La ritmul masurat al autorului (34 de porniri de sesiune/zi), inseamna aproximativ 1,8M tokens/zi de context care nu se mai incarca — iar recall-ul a devenit mai bun, nu mai slab.

Mentiuni oneste: tokens estimati la ~4 caractere/token; cu prompt caching economiile facturate sunt mai mici decat cifrele brute; e setup-ul unui singur user, nu un studiu controlat.

Capturi de ecran

Dashboard-ul mem0ry4ai — carduri de status, health checks, activitate recenta cu sursa, memorii grupate pe proiect.

Dashboard-ul: contoare live, health checks, activitate recenta cu atribuirea sursei, memorii grupate pe proiect.

Pagina de proiect mem0ry4ai — status si todos pinned sus, cunostintele grupate pe tip.

Pagina „unde am ramas?" per proiect — status si todo primele.

Coada de review mem0ry4ai — candidati extrasi de LLM asteapta aprobarea umana, inclusiv un candidat junk supra-increzator.

Coada de review. Observa candidatul junk la confidence 0.95 — exact de-asta nimic nu se scrie automat.

Pagina Istoric git — timeline-ul memoriei cu diff-uri colorate per commit si buton de commit din UI.

Istoric git (v0.2.0): timeline-ul memoriei — diff-uri per commit, supersedarile vizibile in rosu/verde, commit din UI.

„Ce vede Claude": injectarea exacta de la SessionStart, cu costul in bytes si tokens. Toate capturile folosesc date demo.

Instalare

Cloneaza repo-ul:

git clone https://github.com/cremenescu/mem0ry4ai.git && cd mem0ry4ai

CLI-ul merge imediat: ./mem.py add, list, search, supersede.
Porneste web UI-ul: ./server_web.sh → http://127.0.0.1:8841/
Leaga-l de Claude Code:
```
python3 hooks/install.py --target user
```
apoi reporneste Claude Code (sau /clear). De-acum fiecare sesiune porneste cu memoriile tale injectate.

Datele raman ale tale. Totul traieste in store/*.md pe masina ta, versionat cu git-ul tau local. Fara cloud, fara telemetrie, fara chei API.

Ce nu exista inca

Embeddings vectoriale (FTS5 e suficient la scara personala; raman un posibil add-on).
Autentificare pe web UI (gandit pentru localhost).
Hooks pentru alti agenti in afara de Claude Code (CLI-ul si formatul sunt agnostice).

Licenta & multumiri

mem0ry4ai e publicat sub GPL-2.0-or-later. Construit cu Python, PHP, SQLite FTS5 — si o neincredere sanatoasa in modelele de limbaj supra-increzatoare.

Changelog

Oglindeste exact release-urile GitHub. Cele mai noi primele.

v0.3.0 · 2026-06-10

Checkpoint git automat la finalul sesiunii.

Auto-checkpoint — hook-ul de SessionEnd comite singur store/; memoriile scrise in sesiune ajung in istoricul git fara nicio actiune manuala.
Panoul Health: store-ul necomis e o stare gri informativa, nu o eroare rosie — e conditia normala mid-sesiune.
Butonul de commit din pagina Istoric git ramane pentru checkpoint-uri manuale cu mesaj propriu.

v0.2.0 · 2026-06-10 — Pagina Istoric git

Pagina Istoric git — timeline-ul store-ului in web UI: fiecare commit care atinge store/, cu diff colorat incarcat lazy.
Commit din UI — schimbarile necomise din store sunt listate, cu buton care comite doar fisierele de memorie (autor mem0ry4ai web, fara signing, nu atinge codul).
README: sectiunea Measured impact (cifre reale before/after) + galerie de screenshots cu date demo.

v0.1.0 · 2026-06-10 — Primul release public

Markdown + git ca sursa de adevar — auditabil, supersedare-nu-stergere; indexul SQLite FTS5 e derivat si regenerabil.
Hooks Claude Code: injectare la SessionStart (scoped per proiect, index plafonat multi-proiect din radacina unui monorepo), captura de pointeri la transcript la SessionEnd/PreCompact.
Captura cu gate de incredere: agentul cu context scrie direct; extractia offline cu LLM local (Ollama) trece prin coada de review umana.
Tipuri dedicate todo si status — primele la injectare si in UI.
Web UI: dashboard cu health checks si live updates, pagini per proiect, cautare FTS5, operatii bulk, lant de supersedare, preview „Ce vede Claude", coada de review. Bilingv EN/RO.
Server standalone (php -S cu PHP_CLI_SERVER_WORKERS), pornit automat de hook-ul de sesiune. Binarele se rezolva din PATH cu override-uri din env.

Feedback

Bug-uri si cereri de functionalitati: issue tracker.
Contact direct: razvan@cremenescu.ro.