← Torna al blog
Aicirca 6 min di lettura

claude-mem dà all'agente uno schedario, non una memoria

Pubblicato 2 nov 2026
claude-mem dà all'agente uno schedario, non una memoria

Ogni coding agent ha la stessa abitudine imbarazzante. Passi un pomeriggio a spiegargli perché il middleware di autenticazione non si tocca, dove vive la vecchia configurazione e quali due test sono instabili di proposito. Poi chiudi il portatile. La mattina dopo l'agente ti saluta come un estraneo e ti propone con entusiasmo di rifattorizzare proprio il file che gli avevi detto di lasciare in pace.

È su quel vuoto che punta claude-mem, e i numeri dicono che in molti lo sentono. Il repository sta intorno alle 110.000 stelle, ne ha prese circa 5.850 nell'ultima settimana ed è in cima alla classifica settimanale di GitHub trending da giorni. Il progetto di Alex Newman si definisce «sistema di compressione di memoria persistente» per Claude Code, e la parola chiave è compressione, non archiviazione.

Cosa viene salvato davvero

Il meccanismo è meno magico della presentazione. claude-mem si aggancia agli hook del ciclo di vita che Claude Code già espone: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd. Ogni hook è un comando solo, claude-mem hook claude-code <event>, lanciato da un piccolo launcher che l'installer mette nel PATH.

Mentre lavori, le chiamate agli strumenti diventano «osservazioni»: brevi note semantiche su cosa ha fatto l'agente e cosa è successo. Un servizio worker in background, gestito da Bun, le scrive in SQLite. All'avvio di una nuova sessione, le osservazioni più pertinenti vengono reiniettate nel contesto prima che tu abbia digitato qualcosa.

Nello stack c'è anche un database vettoriale Chroma per la ricerca semantica, accanto a FTS5 di SQLite per quella per parole chiave. In pratica l'ibrido conta: «quello script di migrazione di martedì» è una query per parole chiave, «la cosa in cui il refresh del token fallisce in silenzio» è semantica, e le scriverai tutte e due.

Due dettagli meritano una nota, perché mostrano che il progetto è stato usato sul campo. Primo, un tag <private>: ciò che ci sta dentro non viene mai salvato. Secondo, gli screenshot sono opt-in e spenti di default, e arrivano al modello osservatore solo se l'inferenza sulle immagini è abilitata a parte. Qualcuno ha pensato al caso in cui uno strumento di memoria diventa, in silenzio, uno strumento di sorveglianza.

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

Il trucco del recupero a tre livelli

La parte che trovo davvero ben progettata è la superficie di ricerca. Invece di buttare le memorie nel contesto sperando che il modello le riordini, claude-mem espone un flusso MCP in tre passi.

search restituisce un indice compatto con gli ID, più o meno 50-100 token per risultato. timeline dà il contesto cronologico intorno a un risultato interessante. get_observations recupera il dettaglio completo, 500-1.000 token ciascuno, ma solo per gli ID che hai scelto davvero. Il README parla di circa 10 volte tanto in risparmio di token filtrando prima di recuperare, che è il tipo giusto di promessa: un argomento di contabilità, non di capacità.

È la differenza tra un sistema di memoria e una finestra di contesto. Una finestra più grande è un costo fisso che paghi a ogni turno. La divulgazione progressiva è un costo che paghi solo quando vai a cercare. Chi ha visto una sessione lunga bruciare token su output vecchi sa quale delle due scala.

L'installazione è una riga, e il punto è quello

Il percorso felice è:

npx claude-mem install

Funziona con --ide opencode, --ide t3code, --ide pi, --ide antigravity e qualche altro, più una modalità Grok Bot che legge i log della chat perché quell'host non ha hook. Dentro Claude Code si può passare anche dal marketplace dei plugin:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Serve Node 20 o successivo. Bun e uv vengono tirati dentro da soli se mancano. Su Windows l'installer mette un launcher in %LOCALAPPDATA%\claude-mem\bin e lo aggiunge al PATH utente; se gli hook si lamentano di un eseguibile mancante, npx claude-mem doctor è il punto di partenza per il troubleshooting.

Una trappola che il README ripete: npm install -g claude-mem installa solo l'SDK. Non registra gli hook né prepara il worker, quindi non succede nulla e penserai che lo strumento sia rotto.

La parte che mi mette a disagio

Durante l'installazione ti chiedono di accedere con un magic link via email, senza carta. L'accesso prepara una chiave di memoria e sblocca un osservatore ospitato con 30 giorni di prova; finita la prova, la memoria torna sul tuo piano Anthropic, a meno che tu non si abboni. Puoi saltare tutto passando --provider, impostando CLAUDE_MEM_ONLINE_OPTIN=false o girando in CI. Fin qui, niente da dire.

Poi, verso il fondo del README, c'è una sezione intitolata «What About CMEM?» che spiega che CMEM è un token creato da terzi e «ufficialmente abbracciato» dall'autore del progetto, con tanto di contract address.

Non penso che questo renda il software cattivo. Il codice è Apache-2.0, l'architettura è documentata, e la scelta di licenza è motivata esplicitamente come scommessa sull'incorporare memoria durevole negli strumenti per sviluppatori. Però un sistema di memoria che arriva con una memecoin e ti chiede di accedere prima di iniziare a ricordare pretende un tipo particolare di fiducia, e conviene decidere se concederla prima di puntarlo su un repository privato. La via solo locale esiste. Usatela di proposito, non per caso.

La memoria rende davvero migliori gli agenti?

La risposta onesta è: li rende meno ripetitivi. Non è la stessa cosa. Un'osservazione ricordata è un'affermazione sul passato, e il codice nel frattempo si è probabilmente mosso. Se il contesto iniettato dice «la migrazione sta in db/legacy.ts» e qualcuno ha spezzato quel file tre settimane fa, non hai dato conoscenza all'agente, gli hai dato sicurezza su un fatto scaduto.

La cornice di claude-mem aiuta: le osservazioni sono citate per ID e puoi ispezionarle nel viewer locale, all'URL del worker. Trattale come appunti, non come verità. I progetti che ne ricaveranno qualcosa saranno quelli che potano, non quelli che accumulano.

C'è anche un effetto di secondo ordine, ed è quello che guarderei. La memoria cambia ciò che un agente è disposto a fare senza chiedere. Un agente con uno storico procede volentieri su assunzioni ereditate dalla settimana prima. È un guadagno di produttività fino al momento esatto in cui diventa un malinteso molto costoso.

A chi serve

Se le tue sessioni sono brevi e autoconclusive, lascia perdere. Il sovraccarico non vale la pena e un contesto pulito è una funzione.

Se lavori per giorni sullo stesso repository, se continui a rispiegare le stesse decisioni architetturali, o se hai agenti in parallelo che devono sapere cosa hanno concluso gli altri, questa è al momento l'implementazione aperta più completa di quell'idea, e l'installazione in una riga fa costare l'esperimento dieci minuti.

Entra però con l'aspettativa giusta. claude-mem non dà una memoria al tuo agente. Gli dà uno schedario, uno strumento di ricerca e l'abitudine a scrivere le cose. Se le note siano ancora vere resta, come sempre, un problema tuo.

Articoli correlati