Skip to content

README.it.md

Latest commit

 

History

History
431 lines (316 loc) · 18.3 KB

README.it.md

File metadata and controls

431 lines (316 loc) · 18.3 KB
Raw

🌐 Questa è una traduzione automatica. Le correzioni della comunità sono benvenute!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Sistema di compressione della memoria persistente creato per Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

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.

Avvio Rapido

Installa con un singolo comando:

npx claude-mem install

Oppure installa per OpenCode:

npx claude-mem install --ide opencode

Oppure installa per Antigravity CLI (guida all'installazione):

npx claude-mem install --ide antigravity

Oppure installa dal marketplace dei plugin all'interno di Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticamente nelle nuove sessioni.

Nota: Claude-Mem è pubblicato anche su npm, ma npm install -g claude-mem installa solo l'SDK/libreria — non registra gli hook del plugin né configura il servizio worker. Installa sempre tramite npx claude-mem install o i comandi /plugin sopra indicati.

🦞 OpenClaw Gateway

Installa claude-mem come plugin di memoria persistente sui gateway OpenClaw con un singolo comando:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Il programma di installazione gestisce le dipendenze, la configurazione del plugin, la configurazione del provider AI, l'avvio del worker e i flussi opzionali di osservazione in tempo reale verso Telegram, Discord, Slack e altro ancora. Consulta la Guida all'Integrazione OpenClaw per i dettagli.

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 all'URL del worker stampato all'avvio
  • 💻 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 tramite l'API del worker o visualizza tutto nel web viewer

Documentazione

📚 Visualizza Documentazione Completa - Sfoglia sul sito ufficiale

Per Iniziare

Best Practice

Architettura

Configurazione e Sviluppo

Come Funziona

Componenti Principali:

  1. 5 Hook del Ciclo di Vita - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 script hook)
  2. Installazione Intelligente - Controllo delle dipendenze in cache (script pre-hook, non un hook del ciclo di vita)
  3. Servizio Worker - API HTTP locale con interfaccia web viewer ed endpoint di ricerca, gestita da Bun
  4. Database SQLite - Memorizza sessioni, osservazioni, riepiloghi
  5. Skill mem-search - Query in linguaggio naturale con divulgazione progressiva
  6. Database Vettoriale Chroma - Ricerca ibrida semantica + keyword per recupero intelligente del contesto

Vedi Panoramica dell'Architettura per i dettagli.

Strumenti di Ricerca MCP

Claude-Mem fornisce una ricerca intelligente della memoria attraverso 4 strumenti MCP, seguendo un pattern di flusso di lavoro a 3 livelli efficiente in termini di token:

Il Flusso di Lavoro a 3 Livelli:

  1. search - Ottieni un indice compatto con gli ID (~50-100 token/risultato)
  2. timeline - Ottieni il contesto cronologico attorno ai risultati interessanti
  3. get_observations - Recupera i dettagli completi SOLO per gli ID filtrati (~500-1.000 token/risultato)

Come Funziona:

  • Claude utilizza gli strumenti MCP per cercare nella tua memoria
  • Inizia con search per ottenere un indice dei risultati
  • Usa timeline per vedere cosa stava accadendo attorno a osservazioni specifiche
  • Usa get_observations per recuperare i dettagli completi degli ID rilevanti
  • Risparmio di token di circa 10 volte filtrando prima di recuperare i dettagli

Strumenti MCP Disponibili:

  1. search - Cerca nell'indice della memoria con query full-text, filtri per tipo/data/progetto
  2. timeline - Ottieni il contesto cronologico attorno a un'osservazione o query specifica
  3. get_observations - Recupera i dettagli completi delle osservazioni tramite ID (raggruppa sempre più ID insieme)

Esempio di Utilizzo:

// Passo 1: Cerca per ottenere l'indice
search(query="authentication bug", type="bugfix", limit=10)

// Passo 2: Rivedi l'indice, identifica gli ID rilevanti (es. #123, #456)

// Passo 3: Recupera i dettagli completi
get_observations(ids=[123, 456])

Vedi Guida agli Strumenti di Ricerca per esempi dettagliati.

Release Branches

Le release stabili vengono pubblicate da main e distribuite su npm. core-dev e community-edge sono branch eseguiti dal sorgente per correzioni di affidabilità anticipate e integrazioni della community. Vedi Release Branches per il flusso dei branch e le istruzioni di esecuzione non stabili.

Requisiti di Sistema

  • Node.js: 20.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)

Note per la Configurazione su Windows

Se visualizzi un errore simile a:

npm : The term 'npm' is not recognized as the name of a cmdlet

Assicurati che Node.js e npm siano installati e aggiunti al tuo PATH. Scarica l'ultimo installer di Node.js da https://nodejs.org e riavvia il terminale dopo l'installazione.

Configurazione

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.

Configurazione di Modalità e Lingua

Claude-Mem supporta più modalità di flusso di lavoro e lingue tramite l'impostazione CLAUDE_MEM_MODE.

Questa opzione controlla sia:

  • Il comportamento del flusso di lavoro (es. code, chill, investigation)
  • La lingua utilizzata nelle osservazioni generate

Come Configurare

Modifica il tuo file di impostazioni in ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Le modalità sono definite in plugin/modes/. Per vedere tutte le modalità disponibili localmente:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Modalità Disponibili

Modalità Descrizione
code Modalità predefinita in inglese
code--zh Modalità in cinese semplificato
code--ja Modalità in giapponese

Le modalità specifiche per lingua seguono il pattern code--[lang], dove [lang] è il codice lingua ISO 639-1 (es. zh per il cinese, ja per il giapponese, es per lo spagnolo).

Nota: code--zh (cinese semplificato) è già incluso di default — non è richiesta alcuna installazione aggiuntiva o aggiornamento del plugin.

Dopo aver Cambiato Modalità

Riavvia Claude Code per applicare la nuova configurazione di modalità.

Sviluppo

Vedi la Guida allo Sviluppo per le istruzioni di build, test e flusso di contribuzione.

Risoluzione dei Problemi

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.

Segnalazione Bug

Crea report di bug completi con il generatore automatizzato:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Contribuire

I contributi sono benvenuti! Per favore:

  1. Fai il fork del repository
  2. Crea un branch per la funzionalità
  3. Apporta le tue modifiche con i test
  4. Aggiorna la documentazione
  5. Invia una Pull Request

Claude-Mem viene distribuito da tre branch: main (stabile), core-dev e community-edge. Solo main viene pubblicato su npm; gli altri vengono eseguiti dal sorgente. Vedi Release Branches per la strategia e le istruzioni di esecuzione locale.

Vedi Guida allo Sviluppo per il flusso di contribuzione.

Licenza

Claude-Mem è distribuito con licenza Apache License 2.0.

Abbiamo scelto Apache-2.0 perché una memoria agentica durevole dovrebbe essere facile da integrare in strumenti per sviluppatori, agenti locali, server MCP, sistemi aziendali, stack di robotica e harness di agenti in produzione.

Vedi il file LICENSE per i dettagli completi. Vedi docs/license.md e docs/ip-boundary.md per l'ambito della licenza e il confine tra open source e commerciale.

Nota su Ragtime: la directory ragtime/ è distribuita con licenza Apache License 2.0. Vedi ragtime/LICENSE per i dettagli.

Supporto

Creato con Claude Agent SDK | Funziona con Claude Code | Realizzato con TypeScript

E il CMEM?

CMEM è un token creato da terze parti ma ufficialmente adottato dal creatore di Claude-Mem (Alex Newman, @thedotmack). Il token funge da catalizzatore per la community, favorendo la crescita e fungendo da veicolo per portare CMEM agli sviluppatori e ai knowledge worker che ne hanno più bisogno.

CA BASE Ufficiale: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3