Aller au contenu principal

Trois façons de construire

Mnemosyne OS ouvre trois portes. Transports différents, manifestes différents, bibliothèques différentes. Choisissez la vôtre en premier.

Vous voulez construireUtilisezÇa tourne
Une fenêtre dans le canvas Mnemosyne : un outil, un panneau, une app sur MnemoHubCartoucheen iframe sandboxée dans l'app
Un programme à vous : un service Node, un agent, une app bureau ou web séparéeApp Layer 2en processus autonome, via WebSocket local
L'accès mémoire pour un assistant IA que vous utilisez déjà (Claude, Cursor, Hermes)Serveur MCPen serveur MCP lancé par votre assistant

Des pixels dans Mnemosyne : cartouche. Votre propre processus : Layer 2. Un agent IA : MCP.

Cartouche​

Une app React ou Vite chargée dans une iframe sandboxée à l'intérieur de la fenêtre Mnemosyne. Pas de Node, pas d'Electron, pas de système de fichiers. Chaque appel à l'OS est un postMessage asynchrone passé par le SDK.

  • Bibliothèque : @mnemosyne_os/cartridge-sdk
  • Manifeste : mnemo-plugin.json
  • Permissions : vault:read, vault:write, model:infer, dialog:open, metrics:read, settings:read, settings:write, scout:run. Vous les déclarez, l'utilisateur les accorde.
  • Distribution : MnemoHub, ou un dépôt public depuis lequel on installe directement.
  • Commencez ici : Votre première cartouche.

App Layer 2​

Un programme autonome qui se connecte à l'OS en marche sur ws://127.0.0.1:7799. Votre code tourne dehors, la mémoire reste sur la machine.

  • Bibliothèque : @mnemosyne_os/sdk (MnemoClientBrowser pour le navigateur et les renderers Electron, MnemoClient pour Node)
  • Manifeste : app.manifest.json
  • Portées : par coffre et par intention, comme vault:read:DEV, vault:write:SOCIAL, llm:query. Vérifiées côté serveur.
  • Générer le projet en une commande :
npm create @mnemosyne_os/app my-app
import { MnemoClientBrowser } from '@mnemosyne_os/sdk';

const client = await MnemoClientBrowser.connect();
await client.register(manifest);            // la forme de app.manifest.json
const hits = await client.query('décisions refactor JWT', 'DEV', 10);

Serveur MCP​

Aucune ligne de code. Branchez Claude Desktop, Claude Code, Cursor ou Hermes sur @mnemosyne_os/mcp et votre assistant interroge et écrit vos coffres comme des outils.

Installation, un bloc de config par client : Connecter Claude à Mnemosyne.

Ne pas mélanger les deux SDK​

@mnemosyne_os/sdk et @mnemosyne_os/cartridge-sdk sont des bibliothèques différentes pour des rails différents. Le SDK Layer 2 dans une cartouche vous donne un client WebSocket que la sandbox ne laissera jamais se connecter.

L'app le rattrape : un dossier contenant un app.manifest.json est refusé, avec un message qui dit qu'une cartouche exige mnemo-plugin.json.

La passerelle est toujours ouverte​

Aucun interrupteur. Tant que Mnemosyne OS est ouvert, le port 7799 écoute. Fermez l'app et les surfaces externes se taisent.