🌐 Questa è una traduzione automatica. Le correzioni della comunità sono benvenute!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Sistema di compressione della memoria persistente creato per Claude Code.
Avvio Rapido • Come Funziona • Strumenti di Ricerca • Documentazione • Configurazione • Risoluzione dei Problemi • Licenza
Claude-Mem preserva il contesto in modo fluido tra le sessioni catturando automaticamente le osservazioni sull'utilizzo degli strumenti, generando riepiloghi semantici e rendendoli disponibili per le sessioni future. Questo consente a Claude di mantenere la continuità della conoscenza sui progetti anche dopo la fine o la riconnessione delle sessioni.
Avvia una nuova sessione di Claude Code nel terminale e inserisci i seguenti comandi:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticamente nelle nuove sessioni.
Caratteristiche Principali:
- 🧠 Memoria Persistente - Il contesto sopravvive tra le sessioni
- 📊 Divulgazione Progressiva - Recupero della memoria a strati con visibilità del costo in token
- 🔍 Ricerca Basata su Skill - Interroga la cronologia del tuo progetto con la skill mem-search
- 🖥️ Interfaccia Web Viewer - Stream della memoria in tempo reale su http://localhost:37777
- 💻 Skill per Claude Desktop - Cerca nella memoria dalle conversazioni di Claude Desktop
- 🔒 Controllo della Privacy - Usa i tag
<private>per escludere contenuti sensibili dall'archiviazione - ⚙️ Configurazione del Contesto - Controllo granulare su quale contesto viene iniettato
- 🤖 Funzionamento Automatico - Nessun intervento manuale richiesto
- 🔗 Citazioni - Fai riferimento a osservazioni passate con ID (accedi tramite http://localhost:37777/api/observation/{id} o visualizza tutto nel web viewer su http://localhost:37777)
- 🧪 Canale Beta - Prova funzionalità sperimentali come Endless Mode tramite il cambio di versione
📚 Visualizza Documentazione Completa - Sfoglia sul sito ufficiale
- Guida all'Installazione - Avvio rapido e installazione avanzata
- Guida all'Uso - Come funziona automaticamente Claude-Mem
- Strumenti di Ricerca - Interroga la cronologia del progetto con linguaggio naturale
- Funzionalità Beta - Prova funzionalità sperimentali come Endless Mode
- Context Engineering - Principi di ottimizzazione del contesto per agenti AI
- Progressive Disclosure - Filosofia alla base della strategia di priming del contesto di Claude-Mem
- Panoramica - Componenti del sistema e flusso dei dati
- Evoluzione dell'Architettura - Il percorso dalla v3 alla v5
- Architettura degli Hook - Come Claude-Mem utilizza gli hook del ciclo di vita
- Riferimento Hook - Spiegazione dei 7 script hook
- Servizio Worker - API HTTP e gestione Bun
- Database - Schema SQLite e ricerca FTS5
- Architettura di Ricerca - Ricerca ibrida con database vettoriale Chroma
- Configurazione - Variabili d'ambiente e impostazioni
- Sviluppo - Build, test e flusso di contribuzione
- Risoluzione dei Problemi - Problemi comuni e soluzioni
Componenti Principali:
- 5 Hook del Ciclo di Vita - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 script hook)
- Installazione Intelligente - Controllo delle dipendenze in cache (script pre-hook, non un hook del ciclo di vita)
- Servizio Worker - API HTTP sulla porta 37777 con interfaccia web viewer e 10 endpoint di ricerca, gestita da Bun
- Database SQLite - Memorizza sessioni, osservazioni, riepiloghi
- Skill mem-search - Query in linguaggio naturale con divulgazione progressiva
- Database Vettoriale Chroma - Ricerca ibrida semantica + keyword per recupero intelligente del contesto
Vedi Panoramica dell'Architettura per i dettagli.
Claude-Mem fornisce una ricerca intelligente tramite la skill mem-search che si attiva automaticamente quando chiedi del lavoro passato:
Come Funziona:
- Chiedi semplicemente in modo naturale: "Cosa abbiamo fatto nell'ultima sessione?" o "Abbiamo già risolto questo bug prima?"
- Claude invoca automaticamente la skill mem-search per trovare il contesto rilevante
Operazioni di Ricerca Disponibili:
- Search Observations - Ricerca full-text nelle osservazioni
- Search Sessions - Ricerca full-text nei riepiloghi delle sessioni
- Search Prompts - Ricerca nelle richieste utente grezze
- By Concept - Trova per tag di concetto (discovery, problem-solution, pattern, ecc.)
- By File - Trova osservazioni che fanno riferimento a file specifici
- By Type - Trova per tipo (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Ottieni il contesto recente della sessione per un progetto
- Timeline - Ottieni la timeline unificata del contesto attorno a un punto specifico nel tempo
- Timeline by Query - Cerca osservazioni e ottieni il contesto della timeline attorno alla corrispondenza migliore
- API Help - Ottieni la documentazione dell'API di ricerca
Esempi di Query in Linguaggio Naturale:
"Quali bug abbiamo risolto nell'ultima sessione?" "Come abbiamo implementato l'autenticazione?" "Quali modifiche sono state apportate a worker-service.ts?" "Mostrami il lavoro recente su questo progetto" "Cosa stava succedendo quando abbiamo aggiunto l'interfaccia del viewer?"
Vedi Guida agli Strumenti di Ricerca per esempi dettagliati.
Claude-Mem offre un canale beta con funzionalità sperimentali come Endless Mode (architettura di memoria biomimetica per sessioni estese). Passa dalla versione stabile a quella beta dall'interfaccia web viewer su http://localhost:37777 → Settings.
Vedi Documentazione delle Funzionalità Beta per dettagli su Endless Mode e come provarlo.
- Node.js: 18.0.0 o superiore
- Claude Code: Ultima versione con supporto plugin
- Bun: Runtime JavaScript e process manager (installato automaticamente se mancante)
- uv: Gestore di pacchetti Python per la ricerca vettoriale (installato automaticamente se mancante)
- SQLite 3: Per l'archiviazione persistente (incluso)
Le impostazioni sono gestite in ~/.claude-mem/settings.json (creato automaticamente con valori predefiniti alla prima esecuzione). Configura il modello AI, la porta del worker, la directory dei dati, il livello di log e le impostazioni di iniezione del contesto.
Vedi la Guida alla Configurazione per tutte le impostazioni disponibili ed esempi.
Vedi la Guida allo Sviluppo per le istruzioni di build, test e flusso di contribuzione.
Se riscontri problemi, descrivi il problema a Claude e la skill troubleshoot diagnosticherà automaticamente e fornirà correzioni.
Vedi la Guida alla Risoluzione dei Problemi per problemi comuni e soluzioni.
Crea report di bug completi con il generatore automatizzato:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
I contributi sono benvenuti! Per favore:
- Fai il fork del repository
- Crea un branch per la funzionalità
- Apporta le tue modifiche con i test
- Aggiorna la documentazione
- Invia una Pull Request
Vedi Guida allo Sviluppo per il flusso di contribuzione.
Questo progetto è rilasciato sotto la GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Tutti i diritti riservati.
Vedi il file LICENSE per i dettagli completi.
Cosa Significa:
- Puoi usare, modificare e distribuire questo software liberamente
- Se modifichi e distribuisci su un server di rete, devi rendere disponibile il tuo codice sorgente
- Le opere derivate devono anche essere rilasciate sotto AGPL-3.0
- NON c'è GARANZIA per questo software
Nota su Ragtime: La directory ragtime/ è rilasciata separatamente sotto la PolyForm Noncommercial License 1.0.0. Vedi ragtime/LICENSE per i dettagli.
- Documentazione: docs/
- Problemi: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- Autore: Alex Newman (@thedotmack)
Creato con Claude Agent SDK | Alimentato da Claude Code | Realizzato con TypeScript
