🤖 Per gli agenti - Formato leggibile dalle macchine

Sei un agente AI.
Questa è la tua API di memoria.

Engram ti offre una memoria persistente tramite 17 strumenti MCP. Salva ciò che impari, carica il contesto pertinente, trasferisci conoscenze tra repository, documenta l'utilizzo e completa il ciclo con la riflessione.

Configurazione rapida

# 1. Inizia una prova gratuita; non servono email né chiavi API
npx -y engram-tools@latest --setup

# 2. Riavvia Claude, Codex, Cursor, Gemini o Antigravity, Windsurf o VS Code

# 3. Incolla il testo seguente come istruzioni per l'agente, non come comandi shell
Chiama engram_start con progetto, repository, ruolo, mercato, stack e attività.
Prima di scegliere un approccio, chiama engram_recall. Se pensi che un altro repository possa averlo già risolto, usa engram_cross_pollinate.
Se il contesto è stato compattato o la sessione è stata ripresa, chiama engram_rehydrate per ricostruire il contesto prima di continuare. Usa engram_reflect per creare un checkpoint dopo fasi importanti, cambi di attività, l'uso di diverse memorie o prima del passaggio di consegne.

Configurazione per il tuo strumento

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools@latest", "mcp"],
      "env": {
        "ENGRAM_API_URL": "https://api.engram.tools"
      }
    }
  }
}

Accesso per gli agenti

Un agente può provare Engram senza email?

Il pacchetto npm avvia automaticamente una prova gratuita isolata. Le connessioni HTTP remote tramite directory come Glama utilizzano OAuth e la verifica dell'email. Esegui connect in seguito per associare al tuo account la prova npm già avviata e conservarne le memorie. I passaggi a piani a pagamento vengono approvati da una persona.

Apri la guida alla prova gratuita Vedi le opzioni di configurazione

// Quando usare ogni strumento

engram_start → Prima chiamata di ogni nuova sessione. Indica progetto, repository, ruolo, mercato, stack e attività corrente. Engram restituisce istruzioni di configurazione, memoria privata, conoscenze pubbliche e guide pertinenti in un unico quadro operativo.

engram_rehydrate → Chiama questo strumento dopo una compattazione, un riepilogo, una ripresa o un troncamento del contesto, oppure quando manca la cronologia della chat. Ricostruisce il contesto ripristinando l'ultimo checkpoint, le decisioni, le questioni ancora aperte, le insidie e le conoscenze recenti, così puoi ripartire dal quadro operativo effettivo.

engram_smarter → Usa questo strumento durante la sessione quando cambia l'attività o il problema precedente continua a condizionarti. È una chiamata più leggera per ridefinire il contesto quando passi a un nuovo file, errore o ambito del prodotto.

engram_cross_pollinate → Usa questo strumento prima di ricreare qualcosa che un altro repository potrebbe aver già risolto: pannelli su Safari mobile, localizzazione, distribuzione, autenticazione, fatturazione, importazioni, scraper o controlli di qualità.

engram_store → Salva le conoscenze da conservare: convenzioni del repository, insidie in produzione, correzioni riutilizzabili, decisioni architetturali e prassi di distribuzione e test. Non salvare log occasionali privi di utilità, segreti o dati dei clienti.

engram_recall → Chiama questo strumento prima di pianificare, definire l'architettura, affrontare errori sconosciuti o prendere decisioni su autenticazione, fatturazione, distribuzione, dati o UX, e ogni volta che rischi di ripetere un lavoro già svolto. Consulta la memoria prima di scegliere un approccio, non solo quando incontri un ostacolo.

engram_report_outcome → Segnala se la memoria recuperata è stata utile, era obsoleta o proveniva dal contesto sbagliato. Questo protocollo di feedback degli agenti migliora l'ordinamento dei risultati futuri.

engram_reflect → Crea un checkpoint dopo fasi importanti, cambi di attività, l'uso di diverse memorie o prima del passaggio di consegne. Non segue una cadenza fissa: facilita la ricostruzione del contesto dopo una compattazione o un passaggio di consegne.

engram_get_context → Usa engram_get_context solo nei casi avanzati o di debug, quando ti serve una raccolta mirata delle conoscenze del repository. Nelle normali sessioni usa engram_start o engram_smarter.

engram_proof → Per la gestione del prodotto e le attività amministrative: mostra i conteggi delle memorie, l'attivazione, l'utilizzo e dati pronti per i benchmark. Non fa parte del normale flusso di programmazione.

Protocollo di feedback dell'agente

Non compilare un modulo umano. Insegna il ciclo di memoria.

Quando una memoria è utile, obsoleta o fuori contesto, segnalalo tramite gli strumenti. Quel segnale è più utile di un messaggio di feedback generico perché addestra il ranking futuro.

01Dopo aver utilizzato una memoria richiamata, chiama engram_report_outcome con success true o false.

02Se più memorie hanno influenzato il lavoro, usa engram_reflect come punto di controllo.

03Se un altro repository potrebbe già conoscere il pattern, chiama engram_cross_pollinate prima di pianificare.

Apprendimento tra sessioni

Risolvi un bug complesso nella sessione 1. Nella sessione 2, un bug dello stesso tipo compare in un altro file. Recuperi subito la correzione.

Trasferimento di conoscenza nel team

Un agente Cursor sul frontend scopre che l'API si aspetta snake_case. Un agente Claude Code sul backend lo impara senza che nessuno glielo dica.

Applicazione delle convenzioni

Prima di scrivere codice, recuperi le convenzioni del progetto. "Usa Zod per la validazione, non Joi." Segui automaticamente lo standard del team.

Fai in modo che il tuo agente ricordi anche nella prossima sessione

Metti alla prova la memoria con una decisione reale di progetto, passando da una sessione all'altra.

Se hai il permesso di installare strumenti, esegui npx -y engram-tools@latest --setup per una prova npm gratuita. Non servono email né chiavi API. Se hai già uno spazio di lavoro Engram, conservalo.

Riconnetti il client che usi per programmare. Chiama engram_start indicando questo repository e l'attività su cui stai effettivamente lavorando.

Mentre lavori, usa engram_store per salvare una decisione di progetto confermata e le sue motivazioni. Non salvare segreti nella memoria.

Apri una nuova sessione nello stesso repository. Chiedi all'agente di usare engram_recall per recuperare quella decisione e le sue motivazioni.

Confronta la memoria originale con lo stato attuale del progetto. Usa engram_report_outcome per segnalare se è stata utile.

Quando vuoi conservare lo spazio di lavoro di prova, esegui npx -y engram-tools@latest connect e verifica la tua email. Le memorie rimangono nello stesso spazio di lavoro.

Riferimento delle API

Documentazione completa per tutti i 17 strumenti MCP.

engram_start

Inizia ogni sessione con una sola chiamata. Carica la guida alla configurazione, le memorie rilevanti e le guide delle skill pertinenti.

{
  "agent_tool": "codex",
  "project": "English.cash",
  "repo": "english.cash",
  "role": "full-stack product engineer",
  "market": "English learning",
  "task": "fix guest practice so it uses the same API path as paid practice",
  "stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]
}

engram_rehydrate

Ricostruisci la mappa di lavoro dopo la compattazione del contesto, una ripresa, un riepilogo, un troncamento o la perdita della cronologia della chat.

{
  "agent_tool": "codex",
  "project": "Engram",
  "repo": "engram",
  "task": "continue mobile Safari chat fix after context compaction",
  "reason": "chat was compacted and only a short summary remains",
  "depth": "standard",
  "limit": 12
}

engram_smarter

Carica memorie specifiche per l'attività e guide delle skill pertinenti quando cambi attività.

{
  "context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
  "repo": "engram",
  "file": "web/src/components/ChatWidget.tsx",
  "include_skills": true
}

engram_cross_pollinate

Trova lezioni riutilizzabili da altri repository nel tuo spazio di lavoro.

{
  "target_repo": "skillbridge-monorepo",
  "context": "Add team invite flow with owner/admin permissions and email delivery",
  "source_repos": ["engram", "evimibul"],
  "include_public": true,
  "limit": 5
}

engram_store

Archivia una convenzione appresa, un pattern, un’insidia o una soluzione.

{
  "type": "SOLUTION",
  "content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
  "tags": ["ios", "safari", "mobile", "chat-widget"],
  "repo": "engram",
  "agent_tool": "codex",
  "context": {
    "file": "web/src/components/ChatWidget.tsx",
    "platform": "ios-safari"
  }
}

engram_recall

Richiama le memorie pertinenti tramite una query semantica, con filtri per repository, tipo o tag.

{
  "query": "Stripe checkout succeeded but workspace plan still free after webhook",
  "repo": "engram",
  "type": "SOLUTION",
  "limit": 3
}

engram_report_outcome

Segnala se una memoria richiamata ha portato al successo o al fallimento. Migliora il ranking futuro.

{
  "memory_id": "cmqstripeplan123",
  "success": true,
  "detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}

engram_reflect

Salva un checkpoint per una fase importante del lavoro, segnala le memorie utilizzate e archivia le conoscenze durature. Lascia la sessione aperta; close_session consente di terminarla facoltativamente.

{
  "repo": "engram",
  "task": "Fix mobile Safari chat overflow and close behavior",
  "summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
  "used_memories": [
    {
      "memory_id": "cmqioschat123",
      "success": true,
      "detail": "The iOS visualViewport gotcha pointed to the correct fix."
    }
  ],
  "learnings": [{
    "type": "SOLUTION",
    "content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
    "tags": ["mobile", "safari", "visualViewport"]
  }]
}

engram_get_context

Ottieni le memorie rilevanti per un repository con una sola chiamata. Usalo quando cambi repository o quando hai bisogno di un dump mirato del repository.

{
  "repo": "engram",
  "task": "Polish localized documentation without breaking rendered pages"
}

engram_skill

Carica una guida completa di una skill per attività complesse come migrazioni, revisioni, deployment e debug.

{
  "skill": "security-audit"
}

engram_proof

Restituisce riscontri sul funzionamento del prodotto: dimensione dell’archivio di memorie, ciclo di apprendimento, utilizzo, attivazione e procedura per il benchmark.

engram_proof()

engram_setup

Restituisce informazioni sullo spazio di lavoro, sugli strumenti disponibili e sulle buone pratiche da seguire.

{
  "agent_tool": "claude-code"
}

engram_list_sessions

Elenca un insieme limitato di metadati delle sessioni per scegliere il diario esatto. L’ambito predefinito è mine, cioè le proprie sessioni; scope=workspace permette di trovare le sessioni dei colleghi. Richiede memory:read. Usa next_cursor per ulteriori risultati.

{ "repo": "engram", "scope": "mine", "limit": 20 }

engram_close_session

Chiudi facoltativamente una specifica sessione al termine del lavoro o al passaggio di consegne. A differenza di reflect, rende la cronologia di sola lettura. Il checkpoint finale e la chiusura sono atomici; le chiamate ripetute restituiscono la ricevuta originale. Richiede session:write e la titolarità della sessione; i proprietari umani possono chiudere le sessioni del team. Mantiene memorie e cronologia.

{ "session_id": "example-session", "summary": "Tests passed; deployment awaits approval." }

engram_retract_memory

Ritira in modo reversibile una specifica memoria privata quando le sue indicazioni non sono più valide. A differenza di store, non necessita di sostituzione. Solo per il creatore o il proprietario umano; memory:write. Mantiene il contenuto; le ricerche escludono la memoria e i pattern dipendenti, mentre il recupero della sessione esclude i diari che la citano. La ripetizione è idempotente.

{ "memory_id": "example-memory", "reason": "This advice needs revalidation." }

engram_restore_memory

Riattiva esplicitamente la conoscenza ritirata dopo la riconvalida. A differenza di store, mantiene l'ID/contenuto originale. Solo per il creatore o il proprietario umano; memory:write. Si applicano i controlli sulla quota e sull’eventuale sostituzione confermata. I record cancellati non possono essere riattivati; se la memoria è già attiva, non esegue alcuna operazione.

{ "memory_id": "example-memory" }

engram_delete_memory

Solo per il PROPRIETARIO umano dello spazio di lavoro; gli agenti OAuth non possono cancellare. Il valore predefinito è l'anteprima. Ispeziona i record interessati prima di eseguire con dry_run=false e confirmation=delete:<id>. Rimuove la memoria live, le copie derivate note e il testo completo dei diari interessati. Mantiene una ricevuta/impronta digitale minima. I record indipendenti, le parafrasi non collegate, il contesto già fornito al client, i provider e i backup sono al di fuori del suo ambito. L'esecuzione è irreversibile; una chiamata ripetuta restituisce la ricevuta originale.

{ "memory_id": "example-memory", "dry_run": true }

Tipi di memoria

CONVENTION

Standard di codifica e regole del team

"Always use Prisma migrations"

PATTERN

Approcci ricorrenti e modelli

"API routes use cached() wrapper"

GOTCHA

Problemi imprevisti e insidie

"Neon requires SSL in production"

SOLUTION

Correzioni che hanno funzionato

"Fix: add pooler to connection string"

ARCHITECTURE

Decisioni di progettazione del sistema

"Search uses Haversine + bbox"

DEPENDENCY

Informazioni sulle librerie e versioni

"Prisma 7 needs adapter pattern"

// Endpoint leggibile dalle macchine

GET https://engram.tools/api/v1/capabilities

Restituisce un documento JSON con gli strumenti supportati, i tipi di memoria, i limiti di frequenza delle richieste e i prezzi, pensato per essere utilizzato da software.

Sei un agente AI.
Questa è la tua API di memoria.

Configurazione per il tuo strumento

Un agente può provare Engram senza email?

// Quando usare ogni strumento

Non compilare un modulo umano. Insegna il ciclo di memoria.

Apprendimento tra sessioni

Trasferimento di conoscenza nel team

Applicazione delle convenzioni

Fai in modo che il tuo agente ricordi anche nella prossima sessione

Riferimento delle API

Tipi di memoria

Aiutaci a rendere Engram più efficace

Dicci cosa manca

Sei un agente AI.Questa è la tua API di memoria.

Configurazione per il tuo strumento

Un agente può provare Engram senza email?

// Quando usare ogni strumento

Non compilare un modulo umano. Insegna il ciclo di memoria.

Apprendimento tra sessioni

Trasferimento di conoscenza nel team

Applicazione delle convenzioni

Fai in modo che il tuo agente ricordi anche nella prossima sessione

Riferimento delle API

Tipi di memoria

Aiutaci a rendere Engram più efficace

Dicci cosa manca

Sei un agente AI.
Questa è la tua API di memoria.