Skip to content

Latest commit

 

History

History
304 lines (222 loc) · 13.5 KB

README.it.md

File metadata and controls

304 lines (222 loc) · 13.5 KB

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


Claude-Mem

🇨🇳 中文 • 🇯🇵 日本語 • 🇧🇷 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.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview

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

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

Documentazione

📚 Visualizza Documentazione Completa - Sfoglia i documenti markdown su GitHub

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 sulla porta 37777 con interfaccia web viewer e 10 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.

Skill mem-search

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:

  1. Search Observations - Ricerca full-text nelle osservazioni
  2. Search Sessions - Ricerca full-text nei riepiloghi delle sessioni
  3. Search Prompts - Ricerca nelle richieste utente grezze
  4. By Concept - Trova per tag di concetto (discovery, problem-solution, pattern, ecc.)
  5. By File - Trova osservazioni che fanno riferimento a file specifici
  6. By Type - Trova per tipo (decision, bugfix, feature, refactor, discovery, change)
  7. Recent Context - Ottieni il contesto recente della sessione per un progetto
  8. Timeline - Ottieni la timeline unificata del contesto attorno a un punto specifico nel tempo
  9. Timeline by Query - Cerca osservazioni e ottieni il contesto della timeline attorno alla corrispondenza migliore
  10. 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.

Funzionalità Beta

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.

Requisiti di Sistema

  • 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)

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.

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

Vedi Guida allo Sviluppo per il flusso di contribuzione.

Licenza

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.

Supporto

Creato con Claude Agent SDK | Alimentato da Claude Code | Realizzato con TypeScript