SupraCortex
La mémoire de projet des agents de code.
Une mémoire de projet local-first pour les agents de code : serveur MCP stdio, CLI, adaptateur OpenCode optionnel, récupération lexicale déterministe, JSONL par défaut, SQLite/FTS5 en option, références de preuve qui peuvent devenir obsolètes.
- Rôle
- Créateur
- Stack
- Node.js 22.6+
- TypeScript
- MCP SDK
- Zod
- SQLite/FTS5
- JSONL
- Biome
Contexte
Les agents de code repartent souvent de zéro, faute de mémoire de projet fiable. SupraCortex propose une mémoire locale que l’agent peut interroger via MCP, sans dépendre d’un service distant.
Le projet est publié sous licence MIT. Il privilégie des résultats reproductibles et des références de preuve explicites.
Contraintes
- Le fonctionnement local-first devait rester possible sans base de données.
- La récupération devait être déterministe pour que les mêmes requêtes donnent les mêmes résultats.
- Les références de preuve devaient rester honnêtes, y compris lorsqu’elles deviennent obsolètes.
Décisions
Récupération lexicale plutôt qu’embeddings
La recherche repose sur une récupération lexicale déterministe, sans modèle d’embedding ni service externe.
CompromisMoins de rappel sémantique, mais des résultats reproductibles et un fonctionnement entièrement local.
JSONL par défaut, SQLite/FTS5 en option
Le stockage par défaut reste un fichier JSONL lisible. SQLite et FTS5 sont disponibles lorsque le volume ou la recherche le justifient.
CompromisDeux modes de stockage à maintenir, mais le chemin simple reste le chemin par défaut.
Des références de preuve qui peuvent vieillir
Chaque souvenir pointe vers sa source. Le système signale quand une référence n’est plus valide au lieu de la présenter comme certaine.
CompromisLe produit expose l’incertitude, ce qui demande plus de travail à l’agent et à l’utilisateur.
Méthode
Spécifier
Le contrat MCP, le format JSONL et les règles de récupération lexicale définis avant d’écrire le serveur.
Orchestrer
Agents sur des périmètres séparés (serveur, CLI, adaptateur OpenCode), avec un schéma commun.
Vérifier
Comportement relu et testé, y compris la façon dont une référence de preuve devient obsolète.
Architecture
Interface
- CLI
- MCP stdio
- Adaptateur OpenCode
Application
- Récupération lexicale
- Références de preuve
- Validation Zod
Données & runtime
- Node.js 22.6+
- TypeScript
- JSONL
- SQLite/FTS5
Une mémoire locale, interrogeable par l’agent, lisible par l’humain.
Livré
- Le serveur MCP stdio et la CLI.
- La récupération lexicale déterministe et les références de preuve.
- Le stockage JSONL par défaut et le mode SQLite/FTS5 optionnel.
- L’adaptateur OpenCode optionnel et la publication MIT.
Ce que je ferais différemment
J’ajouterais un mode de migration explicite entre JSONL et SQLite, pour rendre le passage d’un stockage à l’autre plus prévisible.