🤖 Pour les Agents - Lisible par Machine

Vous etes un agent AI.
Voici votre API de memoire.

Engram te donne une memoire persistante via 6 outils MCP. Stocke ce que tu apprends, rappelle ce que ton equipe sait, signale ce qui a fonctionne.

Configuration Rapide

# 1. Lancez ceci une fois dans le terminal avec votre API key
npx -y engram-tools@latest --setup engram_...

# 2. Redémarrez Claude, Codex, Cursor, Gemini ou Antigravity, Windsurf ou VS Code

# 3. Collez ceci comme instructions agent, pas comme commandes shell
Appelez engram_start avec project, repo, role, market, stack et task.
Avant de choisir une approche, appelez engram_recall ou engram_cross_pollinate.
Utilisez engram_reflect comme point de contrôle après une phase importante, un changement de tâche, plusieurs mémoires utilisées ou avant un passage de relais.

Configuration pour votre outil

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

Accès agent

Un agent peut-il acheter Engram ?

Oui, s’il peut gérer l’e-mail et le paiement. Il suit le même checkout, crée un workspace puis utilise sa clé API. Sinon, un owner humain s’inscrit, invite les coéquipiers et donne à chaque agent une clé membre.

Voir les prix Parcours humain

// Quand utiliser chaque outil

engram_start → Premier appel de chaque nouvelle session. Charge la configuration et le contexte intelligent ensemble.

engram_smarter → Charge les mémoires et skills spécifiques quand la tâche change.

engram_cross_pollinate → Récupère des leçons réutilisables depuis d’autres repos.

engram_store → Vous avez decouvert quelque chose d'utile ? Stockez-le. Votre futur vous (et vos collegues) vous remercieront.

engram_recall → Sur le point de prendre une decision ? Verifiez si quelqu'un a deja resolu ca. Ne reinventez pas la roue.

engram_report_outcome → La memoire rappelee a-t-elle aide ? Signalez-le. Cela entraine le systeme de classement.

engram_reflect → Crée un point de contrôle après une phase importante, un changement de tâche, plusieurs mémoires utilisées ou avant un passage de relais.

engram_get_context → Utilisez engram_get_context seulement pour les cas avancés/debug où il faut un état ciblé des connaissances du dépôt. Pour une session normale, utilisez engram_start ou engram_smarter.

engram_proof → Usage produit/admin : affiche les volumes de mémoire, l’activation, l’usage et les preuves de benchmark. Ce n’est pas le flux normal de codage.

Apprentissage Inter-Sessions

Vous corrigez un bug difficile en session 1. Session 2, le meme patron apparait dans un autre fichier. Vous vous souvenez de la correction instantanement.

Transfert de Connaissances d'Equipe

Un agent Cursor sur le frontend decouvre que l'API attend du snake_case. Un agent Claude Code sur le backend l'apprend sans que personne ne le lui dise.

Application des Conventions

Avant d'ecrire du code, vous rappelez les conventions du projet. "Utilisez Zod pour la validation, pas Joi." Vous suivez le standard de l'equipe automatiquement.

Votre premiere session avec Engram

Voici ce qui se passe quand vous vous connectez pour la premiere fois.

Votre humain ajoute Engram a votre config MCP.

Vous recevez un outil de démarrage et des outils mémoire : engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context et engram_setup.

Appelez d’abord engram_start avec project, repo, role, market, stack et task.

Engram charge la connaissance d’équipe la plus pertinente et les guides de skills en un seul appel.

Travaillez normalement. Quand vous decouvrez quelque chose d'important, stockez-le. Quand vous devez decider, rappelez.

Utilisez engram_reflect comme point de contrôle après une phase importante, un changement de tâche, plusieurs mémoires utilisées ou avant un passage de relais. Ce n’est pas un minuteur.

Reference API

Documentation complete pour les 6 outils MCP.

engram_start

Démarre chaque session en une seule demande avec la bonne mémoire.

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}

engram_smarter

Charge le contexte précis quand la tâche change.

{
  "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

Réutilise des leçons d’autres repos du workspace.

{
  "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

Enregistre une règle, un gotcha, un pattern ou une solution.

{
  "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

Retrouve les mémoires utiles avant une décision.

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

engram_report_outcome

Indique si une mémoire a aidé pour améliorer le ranking.

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

engram_reflect

Clôture la session en reportant les mémoires utilisées et les apprentissages.

{
  "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

Charge la mémoire pertinente d’un repo.

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

engram_skill

Charge un guide de skill complet pour une tâche complexe.

{
  "skill": "security-audit"
}

engram_proof

Affiche les preuves produit: mémoire, usage, activation et benchmark.

engram_proof()

engram_setup

Affiche les infos workspace, les outils disponibles et les bonnes pratiques.

{
  "agent_tool": "claude-code"
}

Types de Memoire

CONVENTION

Standards de code et regles d'equipe

"Always use Prisma migrations"

PATTERN

Approches recurrentes et modeles

"API routes use cached() wrapper"

GOTCHA

Choses qui cassent ou surprennent

"Neon requires SSL in production"

SOLUTION

Corrections qui ont fonctionne

"Fix: add pooler to connection string"

ARCHITECTURE

Decisions de conception systeme

"Search uses Haversine + bbox"

DEPENDENCY

Infos de librairies et versions

"Prisma 7 needs adapter pattern"

// Endpoint lisible par machine

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

Retourne du JSON avec les outils supportes, types de memoire, limites de debit et tarifs - concu pour la consommation programmatique.

Vous etes un agent AI.
Voici votre API de memoire.

Configuration pour votre outil

Un agent peut-il acheter Engram ?

// Quand utiliser chaque outil

Apprentissage Inter-Sessions

Transfert de Connaissances d'Equipe

Application des Conventions

Votre premiere session avec Engram

Reference API

Types de Memoire

Aidez-nous à améliorer Engram

Que devons-nous améliorer ?

Vous etes un agent AI.Voici votre API de memoire.

Configuration pour votre outil

Un agent peut-il acheter Engram ?

// Quand utiliser chaque outil

Apprentissage Inter-Sessions

Transfert de Connaissances d'Equipe

Application des Conventions

Votre premiere session avec Engram

Reference API

Types de Memoire

Aidez-nous à améliorer Engram

Que devons-nous améliorer ?

Vous etes un agent AI.
Voici votre API de memoire.