Kiro Memory
Memoria persistente tra sessioni per assistenti AI di programmazione.
Kiro Memory cattura automaticamente ciò che accade durante le sessioni di sviluppo -- file modificati, strumenti utilizzati, decisioni prese -- e inietta il contesto rilevante all'inizio di ogni nuova sessione. Il tuo assistente AI ricorda ciò che ha appreso ieri, la settimana scorsa e il mese scorso.
npm install -g kiro-memory
kiro-memory install
Il problema
Ogni volta che avvii una nuova sessione con un assistente AI di programmazione, questo riparte da zero. Non ricorda:
- Su quali file hai lavorato ieri
- Quali decisioni architetturali sono state prese
- Quali approcci sono stati provati e scartati
- A che punto eri rimasto in un'attività multi-sessione
Kiro Memory risolve questo problema fornendo un livello di memoria persistente che funziona tra sessioni diverse e tra editor diversi.
Supporto multi-editor
Kiro Memory funziona con tutti i principali assistenti AI di programmazione:
| Editor | Metodo di integrazione | Cattura automatica | Strumenti MCP |
|---|---|---|---|
| Claude Code | Hooks + MCP | Si | Si |
| Cursor | Rules + MCP | Si | Si |
| Windsurf | Rules + MCP | Si | Si |
| Cline | Instructions + MCP | Si | Si |
| Qualsiasi editor MCP | MCP server | -- | Si |
Cosa vede il tuo agente
Quando una nuova sessione inizia, Kiro Memory inietta automaticamente il contesto rilevante. Ecco un esempio di ciò che il tuo assistente AI riceve:
## Kiro Memory — Contesto di sessione
### Attività recente
- [2h fa] Scritto: src/components/Header.tsx — Aggiunta navigazione responsive
- [3h fa] Eseguito: npm run test — 47 superati, 2 falliti (modulo auth)
- [ieri] Decisione: Usare React Query per la gestione dello stato server
- [ieri] Scritto: src/lib/api.ts — Refactoring del client API con logica di retry
### Conoscenza attiva
- **Vincolo (rigido):** Nessuna chiamata API esterna nei componenti SSR
- **Decisione:** Scelto Tailwind CSS 4 rispetto a styled-components per lo styling
- **Euristica:** Eseguire i test prima di committare modifiche al modulo auth
### Checkpoint dell'ultima sessione
**Attività:** Implementare il flusso di autenticazione utente
**Progresso:** Login/logout funzionanti, persistenza della sessione in sospeso
**Prossimi passi:** Aggiungere la rotazione del refresh token, aggiornare il middleware
**File:** src/auth/session.ts, src/middleware/auth.ts
L'agente riceve questo contesto silenziosamente e lo utilizza per garantire continuità tra le sessioni.
Funzionalità principali
Iniezione automatica del contesto
Il contesto viene iniettato all'avvio della sessione tramite hooks (Claude Code) o file di regole (Cursor, Windsurf, Cline). Non è richiesta alcuna azione manuale.
Ricerca vettoriale con similarità semantica
Trova memorie rilevanti per significato, non solo per parole chiave. Utilizza embedding locali -- non servono chiavi API.
kiro-memory semantic-search "authentication error handling"
Ranking intelligente a 4 segnali
Ogni memoria viene classificata utilizzando quattro segnali per far emergere il contesto più rilevante:
- Recency -- Quanto è recente la creazione dell'osservazione
- Frequency -- Quanto spesso appaiono file o concetti correlati
- Similarità semantica -- Quanto la memoria corrisponde al contesto attuale
- Decay -- Deprezzamento automatico delle osservazioni obsolete
Decadimento della memoria
Le osservazioni collegate a file modificati dopo la cattura vengono automaticamente segnalate come obsolete. Il consolidamento unisce le osservazioni duplicate, mantenendo la memoria pulita e aggiornata.
Conoscenza strutturata
Archivia decisioni architetturali, vincoli, euristiche e approcci scartati come elementi di conoscenza di prima classe:
kiro-memory add-knowledge decision "Use PostgreSQL" \
"Chose PostgreSQL over MongoDB for relational data integrity" \
--reason "Need ACID transactions for payment processing" \
--alternatives "MongoDB,SQLite"
Checkpoint e ripresa della sessione
Salva il progresso in qualsiasi momento e riprendi da dove ti eri fermato:
kiro-memory resume # Riprendi l'ultima sessione
kiro-memory resume 42 # Riprendi una sessione specifica
Report di attività
Genera report settimanali o mensili dell'attività di sviluppo:
kiro-memory report --period=weekly --format=md
Dashboard web
Una dashboard di analisi in tempo reale su http://localhost:3001 con:
- Feed di attività in tempo reale tramite Server-Sent Events
- Ricerca spotlight (Ctrl+K / Cmd+K)
- Analisi degli hotspot sui file
- Timeline delle sessioni
- Cambio tema chiaro/scuro
10 strumenti MCP
Una suite completa di strumenti esposti tramite il Model Context Protocol per l'accesso programmatico a ricerca, archiviazione, recupero e analisi delle memorie.
Ricerca full-text
Ricerca per parole chiave basata su SQLite FTS5 con filtri per progetto, tipo e intervallo di date.
TypeScript SDK
Accesso programmatico all'API completa di Kiro Memory per costruire integrazioni e strumenti personalizzati.
Architettura in breve
Editor (Claude Code / Cursor / Windsurf / Cline)
|
|-- Hooks / Rules (cattura automatica)
|-- MCP Server (10 strumenti)
|
v
Kiro Memory Worker (port 3001)
|
|-- SQLite + FTS5 (ricerca full-text)
|-- Vector Index (ricerca semantica)
|-- Web Dashboard (interfaccia in tempo reale)
|
v
~/.kiro-memory/kiro-memory.db
Requisiti
- Node.js >= 18
- Editor supportati: Claude Code, Cursor, Windsurf, Cline, o qualsiasi editor compatibile con MCP