Installazione

Avvio rapido

Installa Kiro Memory globalmente ed esegui la procedura guidata di configurazione:

npm install -g kiro-memory
kiro-memory install

Il comando install rileva automaticamente il tuo editor e configura hooks, file di regole e voci del server MCP. Puoi anche specificare un editor con i flag dedicati.

Requisiti

• Node.js >= 18.0.0
• Strumenti di compilazione (solo Linux/WSL): build-essential e python3 per la compilazione dei moduli nativi

Utenti Linux / WSL

Installa gli strumenti di compilazione prima di eseguire npm install:

sudo apt-get install -y build-essential python3

Configurazione per editor

Claude Code

Claude Code utilizza un sistema di hooks per la cattura automatica e un server MCP per l'accesso agli strumenti.

kiro-memory install --claude-code

Questo crea un file .claude/hooks.json nella radice del progetto con quattro hooks:

Hook	Evento	Scopo
PreToolUse	Prima dell'esecuzione di uno strumento	Iniettare il contesto all'avvio della sessione
PostToolUse	Dopo l'esecuzione di uno strumento	Catturare scritture di file, comandi, ricerche
Notification	Prompt dell'utente inviato	Archiviare i prompt dell'utente per il tracciamento della sessione
Stop	Fine della sessione	Generare riepilogo e checkpoint della sessione

La configurazione degli hooks punta alla CLI di Kiro Memory, che elabora gli eventi e archivia le osservazioni automaticamente.

informazioni

Gli hooks di Claude Code hanno ambito progetto. Esegui kiro-memory install --claude-code in ogni directory di progetto dove desideri il tracciamento della memoria.

Il server MCP viene configurato automaticamente, dando a Claude Code accesso a tutti i 10 strumenti di Kiro Memory (ricerca, archiviazione, ripresa, ecc.).

---

Cursor

Cursor utilizza un file di regole per l'iniezione del contesto e una configurazione MCP per l'accesso agli strumenti.

kiro-memory install --cursor

Questo crea due file:

1. File di regole in .cursor/rules/kiro-memory.mdc:

Il file di regole istruisce Cursor a iniettare il contesto di Kiro Memory all'avvio della sessione e ad archiviare le osservazioni durante la sessione. Contiene direttive affinche l'assistente AI richiami automaticamente gli strumenti MCP.

2. Configurazione MCP in .cursor/mcp.json:

{
  "mcpServers": {
    "kiro-memory": {
      "command": "kiro-memory",
      "args": ["mcp"],
      "env": {}
    }
  }
}

suggerimento

Dopo l'installazione, riavvia Cursor per caricare la nuova configurazione del server MCP.

---

Windsurf

Windsurf utilizza un file di regole e una configurazione MCP, in modo simile a Cursor.

kiro-memory install --windsurf

Questo crea:

1. File di regole in .windsurfrules:

Contiene istruzioni per l'AI di Windsurf affinche utilizzi gli strumenti di Kiro Memory per l'iniezione del contesto e l'archiviazione delle osservazioni.

2. Configurazione MCP nelle impostazioni MCP di Windsurf:

{
  "mcpServers": {
    "kiro-memory": {
      "command": "kiro-memory",
      "args": ["mcp"],
      "env": {}
    }
  }
}

---

Cline

Cline utilizza un file di istruzioni e una configurazione MCP.

kiro-memory install --cline

Questo crea:

1. File di istruzioni in .clinerules:

Contiene direttive per l'assistente Cline affinche interagisca con gli strumenti di Kiro Memory.

2. Configurazione MCP nelle impostazioni MCP di Cline:

{
  "mcpServers": {
    "kiro-memory": {
      "command": "kiro-memory",
      "args": ["mcp"],
      "env": {}
    }
  }
}

---

Editor MCP generico

Qualsiasi editor che supporta il Model Context Protocol puo utilizzare Kiro Memory. Aggiungi la seguente configurazione alle impostazioni MCP del tuo editor:

{
  "mcpServers": {
    "kiro-memory": {
      "command": "kiro-memory",
      "args": ["mcp"],
      "env": {}
    }
  }
}

Dovrai istruire manualmente il tuo assistente AI a richiamare lo strumento get_context all'avvio della sessione e lo strumento store_observation durante la sessione.

Installazione dai sorgenti

Per lo sviluppo o la personalizzazione, installa dal repository GitHub:

git clone https://github.com/auriti-web-design/kiro-memory.git
cd kiro-memory
npm install
npm run build
npm run install:kiro

informazioni

Quando installi dai sorgenti, usa npm run install:kiro al posto di kiro-memory install per collegare la build locale.

Verifica dell'installazione

Dopo l'installazione, esegui il comando diagnostico:

kiro-memory doctor

Questo verifica:

• Compatibilita della versione di Node.js
• Integrita dell'installazione globale
• Presenza dei file hook/regole per gli editor rilevati
• Configurazione del server MCP
• Disponibilita del servizio worker
• Connettivita al database
• Stato del servizio di embedding

Output di esempio:

Kiro Memory Doctor
==================
[OK] Node.js v20.11.0 (>= 18 required)
[OK] kiro-memory v1.7.1 installed globally
[OK] Claude Code hooks configured
[OK] MCP server entry found
[OK] Worker reachable at http://127.0.0.1:3001
[OK] Database: ~/.kiro-memory/kiro-memory.db (284 observations)
[OK] Embeddings: 94% coverage (267/284)

Aggiornamento

Aggiorna all'ultima versione:

npm update -g kiro-memory

Dopo l'aggiornamento, riesegui il comando di installazione per il tuo editor per applicare eventuali modifiche alla configurazione:

kiro-memory install --claude-code  # oppure --cursor, --windsurf, --cline

Disinstallazione

Rimuovi il pacchetto globale:

npm uninstall -g kiro-memory

Per rimuovere i dati archiviati:

rm -rf ~/.kiro-memory

Per rimuovere i file specifici dell'editor:

• Claude Code: Elimina .claude/hooks.json (o rimuovi le voci di Kiro Memory)
• Cursor: Elimina .cursor/rules/kiro-memory.mdc e la voce MCP da .cursor/mcp.json
• Windsurf: Rimuovi le direttive di Kiro Memory da .windsurfrules e la voce MCP
• Cline: Rimuovi le direttive di Kiro Memory da .clinerules e la voce MCP