Guida all'uso

Una volta installato, Kiro Memory funziona automaticamente in background. Questa guida copre i comandi CLI, la dashboard web e i principali flussi di lavoro per interagire con la tua memoria.

Comandi CLI

La CLI kiro-memory fornisce comandi per cercare, archiviare e gestire la tua memoria.

Comando	Alias	Descrizione
install	--	Configura hooks e MCP per il tuo editor
context	ctx	Mostra il contesto del progetto corrente
search <query>	--	Ricerca full-text per parole chiave (FTS5)
semantic-search <query>	sem	Ricerca ibrida vettoriale + parole chiave
observations	obs	Mostra le osservazioni recenti
summaries	sum	Mostra i riepiloghi recenti
add-observation <title> <content>	add-obs	Aggiungi manualmente un'osservazione
add-summary <content>	add-sum	Aggiungi manualmente un riepilogo di sessione
add-knowledge <type> <title> <content>	add-k	Archivia conoscenza strutturata
resume [session-id]	--	Riprendi da un checkpoint precedente
report	--	Genera un report di attivita
decay	--	Gestione del decadimento della memoria
embeddings	emb	Gestione degli embedding vettoriali
doctor	--	Esegui diagnostica dell'ambiente

Visualizzazione del contesto

Visualizza cio che Kiro Memory conosce del tuo progetto corrente:

kiro-memory context

Questo mostra:

• Osservazioni recenti (scritture di file, comandi, ricerche)
• Riepiloghi delle sessioni
• Elementi di conoscenza attivi (decisioni, vincoli, euristiche)
• Informazioni sull'ultimo checkpoint

Ricerca nella memoria

Ricerca per parole chiave

Cerca utilizzando la ricerca full-text SQLite FTS5:

kiro-memory search "authentication middleware"

I risultati includono osservazioni e riepiloghi corrispondenti con punteggi di rilevanza.

Ricerca semantica

Trova memorie per significato utilizzando gli embedding vettoriali:

kiro-memory semantic-search "how to handle user login errors"
# oppure usa l'alias
kiro-memory sem "how to handle user login errors"

La ricerca semantica combina la similarita vettoriale con la corrispondenza per parole chiave (ricerca ibrida) per restituire i risultati piu rilevanti anche quando i termini esatti non coincidono.

Dashboard web

Kiro Memory include una dashboard web in tempo reale accessibile su:

http://localhost:3001

Il worker si avvia automaticamente quando inizia la sessione del tuo editor. Puoi anche gestirlo manualmente:

kiro-memory worker:start    # Avvia il worker
kiro-memory worker:stop     # Ferma il worker
kiro-memory worker:status   # Verifica lo stato
kiro-memory worker:logs     # Visualizza i log recenti
kiro-memory worker:tail     # Segui i log in tempo reale

Funzionalita della dashboard

• Feed in tempo reale -- Flusso di osservazioni in tempo reale tramite Server-Sent Events (SSE). Visualizza scritture di file, comandi e ricerche nel momento in cui avvengono.
• Ricerca spotlight -- Premi Ctrl+K (o Cmd+K su macOS) per aprire la ricerca istantanea tra tutte le osservazioni e i riepiloghi.
• Analisi -- Timeline delle attivita, analisi degli hotspot sui file, statistiche delle sessioni e distribuzione per tipo di osservazione.
• Cambio tema -- Passa dal tema scuro a quello chiaro.
• Filtro per progetto -- Visualizza la memoria per un progetto specifico o per tutti i progetti.

Checkpoint e ripresa della sessione

Come funzionano i checkpoint

Quando una sessione di sviluppo termina, Kiro Memory crea automaticamente un checkpoint contenente:

• Attivita: Su cosa stavi lavorando
• Progresso: Cosa e stato realizzato
• Prossimi passi: Azioni consigliate per la sessione successiva
• Domande aperte: Punti irrisolti
• File rilevanti: File che sono stati modificati (fino a 20)

Riprendere una sessione

Riprendi dall'ultimo checkpoint:

kiro-memory resume

Riprendi una sessione specifica tramite ID:

kiro-memory resume 42

L'output della ripresa fornisce un riepilogo strutturato:

## Checkpoint della sessione #42

**Attivita:** Implementare l'integrazione per l'elaborazione dei pagamenti
**Progresso:** Stripe SDK integrato, handler webhook creato
**Prossimi passi:**
  - Aggiungere chiavi di idempotenza alle richieste di pagamento
  - Scrivere test per la verifica della firma webhook
  - Aggiornare la gestione degli errori nel flusso di checkout
**File rilevanti:**
  - src/payments/stripe.ts
  - src/webhooks/payment.ts
  - tests/payments/stripe.test.ts

suggerimento

Quando usi Claude Code, lo strumento MCP resume_session e disponibile per il tuo assistente AI. Puo riprendere automaticamente il contesto senza che tu debba eseguire la CLI.

Report di attivita

Genera report di attivita di sviluppo che riepilogano osservazioni, sessioni e apprendimenti.

Report settimanale

kiro-memory report --period=weekly

Report mensile

kiro-memory report --period=monthly

Formati di output

kiro-memory report --format=text      # Testo semplice (predefinito)
kiro-memory report --format=md        # Markdown
kiro-memory report --format=json      # JSON (per uso programmatico)

Salva su file

kiro-memory report --period=weekly --format=md --output=weekly-report.md

Contenuto dei report

I report includono:

• Panoramica: Totale osservazioni, sessioni e arco temporale
• Sessioni: Riepilogo di ogni sessione di sviluppo
• Apprendimenti: Intuizioni chiave scoperte nel periodo
• Attivita completate: Cosa e stato realizzato
• Prossimi passi: Elementi di lavoro in sospeso
• Hotspot dei file: I 10 file piu modificati

Archiviazione della conoscenza strutturata

Gli elementi di conoscenza sono voci di prima classe che persistono indipendentemente dalle sessioni. Rappresentano cio che il tuo team o progetto "conosce".

Tipi di conoscenza

Tipo	Scopo	Esempio
decision	Scelte architetturali o tecniche	"Usare PostgreSQL per dati relazionali"
constraint	Regole che devono essere rispettate	"Nessuna chiamata API esterna in SSR"
heuristic	Preferenze e linee guida non vincolanti	"Eseguire i test prima di committare modifiche all'auth"
rejected	Approcci provati e abbandonati	"MongoDB scartato per mancanza di ACID"

Archiviazione della conoscenza

# Base
kiro-memory add-knowledge decision "Use React Query" \
  "Chose React Query for server state management"

# Con metadati
kiro-memory add-knowledge constraint "No Google Fonts" \
  "Must use system fonts for GDPR compliance" \
  --severity=hard \
  --concepts="gdpr,performance,fonts"

# Approccio scartato con motivazione
kiro-memory add-knowledge rejected "Styled Components" \
  "Evaluated styled-components for styling solution" \
  --reason="Runtime CSS-in-JS adds bundle size and hurts LCP" \
  --alternatives="Tailwind CSS,CSS Modules"

Conoscenza tramite MCP

Il tuo assistente AI puo archiviare conoscenza in modo programmatico usando lo strumento MCP store_knowledge durante una sessione:

"Archiviero questa decisione architetturale in Kiro Memory per riferimento futuro."

Gestione delle osservazioni

Visualizzare le osservazioni recenti

kiro-memory observations         # Ultime 10
kiro-memory obs 25               # Ultime 25

Aggiungere manualmente un'osservazione

kiro-memory add-observation "Deployed v2.1.0" \
  "Deployed version 2.1.0 to production with auth fixes"

Visualizzare i riepiloghi

kiro-memory summaries            # Ultimi 5
kiro-memory sum 10               # Ultimi 10

Decadimento della memoria

Col tempo, le osservazioni possono diventare obsolete man mano che i file cambiano. Kiro Memory rileva e gestisce questo processo automaticamente.

Controllare le statistiche di decadimento

kiro-memory decay stats

Output:

Memory Decay Statistics
=======================
Total observations:    284
Stale:                  12 (4.2%)
Never accessed:         34 (12.0%)
Recently accessed:     238 (83.8%)

Rilevare le osservazioni obsolete

Segnala le osservazioni i cui file collegati sono stati modificati dopo la cattura:

kiro-memory decay detect-stale

Consolidare i duplicati

Unisci le osservazioni duplicate (stesso file e tipo), mantenendo la piu recente:

kiro-memory decay consolidate            # Esegui
kiro-memory decay consolidate --dry-run  # Solo anteprima

Gestione degli embedding

Controllare la copertura degli embedding

kiro-memory embeddings stats

Generare gli embedding mancanti

Genera gli embedding per le osservazioni che ne sono prive:

kiro-memory embeddings backfill        # Batch predefinito di 50
kiro-memory embeddings backfill 200    # Dimensione batch personalizzata

informazioni

Gli embedding vengono generati localmente utilizzando il modello di embedding integrato. Non sono necessarie chiavi API o servizi esterni.