Generated banner for Mnemosyne-Neural-OS
Generated logo for Mnemosyne-Neural-OS

Mnemosyne-Neural-OS

Memory serverOfficial Mnemosyne OS project

Created by Tony Trochet / XPACEGEMS ECOSYSTEMS

Published in Mnemosyne-OS/Mnemosyne-Neural-OS. Publisher page

22 GitHub stars

What it is

Mnemosyne OS — open developer ecosystem (SDK, CLI, examples)
— the description by Tony Trochet / XPACEGEMS ECOSYSTEMS

AutoGineer overview, from the brain’s own files

Mnemosyne OS is a local-first memory operating system designed to serve as the relationship layer between users and their AI agents. Unlike cloud-based memory libraries, it runs as a persistent daemon on the user's machine, managing memory, context, and compute resources. It provides a structured environment where agents can store, retrieve, and consolidate information across sessions. The system features a hybrid memory model using SQLite and vector stores, governed by fine-grained access control. It is designed to be sovereign, ensuring that memory remains on the user's device while providing a standardized interface for agents to interact with personal data through an MCP server or SDK.

How it works

Memory model: Hybrid

AutoGineer overview, from the brain’s own files

Mnemosyne OS functions as a desktop-based memory daemon. It organizes data into vaults, which are partitioned by domain and protected by encryption. The system uses a hybrid approach, combining SQLite for structured data and vector stores for semantic retrieval. It employs a spine engine to classify memories and a consolidation engine called Dream State to link information during idle time. Agents interact with this memory through a Gateway using a signed intent protocol, ensuring that all operations are validated and governed by the user. The OS manages hardware resources, such as GPU/CPU dispatch for local models, and provides a visual interface for users to oversee agentic memory access.

Folders
FolderRoleFiles
.githubagent-config10
archivearchive23
assetsattachments32
docdocs9
examplesexamples16
hookshooks3
packagessource-code198
skillsagent-instructions1
toolsscripts2
.agentsfolder1
.codex-pluginfolder1
clifolder69
handbookfolder20
labfolder6
standardsfolder2

Requirements

Runtimes: Node.js

Databases: SQLite

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Google Antigravity, Kiro, OpenCode, Amp, Roo Code, Cline, JetBrains Junie, Devin (ex-Windsurf)

Set it up

  1. Not scanned by AutoGineerIts dependencies are installed by npm when you run it and were not scanned by AutoGineer (2 declared). https://www.npmjs.com/package/@mnemosyne_os/mcp
  2. Created by Tony Trochet / XPACEGEMS ECOSYSTEMS. Published in Mnemosyne-OS/Mnemosyne-Neural-OS. Licence: MIT License.

Usage

AutoGineer overview, from the brain’s own files

  • Connecting coding agents like Claude Code or Cursor to local vaults via MCP
  • Building custom AI-powered applications using the Mnemosyne SDK
  • Managing persistent cross-session context for autonomous agents
  • Visualizing memory topologies through the Neural Map interface
  • Consolidating and linking memories during system idle periods
“Connect my coding agent to my local development vault.”
The agent gains access to the specified vault via the MCP server, allowing it to query and ingest project-specific context.
“Record the reasoning behind this architectural decision.”
The agent uses the SDK to ingest the content into the DEV vault with an ARCHITECTURE spine type for future retrieval.

Documentation by Tony Trochet / XPACEGEMS ECOSYSTEMS

<div align="center">

<img src="assets/banner-mnemosyne-os.png" width="100%" alt="Mnemosyne OS Infinity Edition. Your memory. Your machine. Your rules. A sovereign, local-first memory OS the relationship layer between you and every AI." />

The sovereign AI Operating System

Open to build on · Private at the core

Image: Mnemosyne OS trust badge Image: Mnemosyne OS publisher badge

<img src="assets/flags/en.svg" height="14" alt="English" /> English&ensp;·&ensp;<img src="assets/flags/fr.svg" height="14" alt="Français" /> Français&ensp;·&ensp;<img src="assets/flags/es.svg" height="14" alt="Español" /> Español&ensp;·&ensp;<img src="assets/flags/de.svg" height="14" alt="Deutsch" /> Deutsch&ensp;·&ensp;<img src="assets/flags/br.svg" height="14" alt="Português" /> Português&ensp;·&ensp;<img src="assets/flags/ru.svg" height="14" alt="Русский" /> Русский&ensp;·&ensp;<img src="assets/flags/zh.svg" height="14" alt="中文" /> 中文

<br/>

Everyone is building the intelligence. Mnemosyne OS builds the relationship: the memory that makes an AI truly know you, across sessions and across time. On your machine. Yours to see.

→ Why the relationship layer

<br/>

<a href="https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/blob/main/assets/teaser-v2-harness.mp4"><img src="assets/teaser-v2-harness.gif" width="360" alt="Irina, the assistant, made of particles: curiosity is a lovely flaw, but she is still working on her harnesses. Follow Mnemosyne OS for version 2. Her agenda pops open on Friday, 9:00, Build Release 2.0. Oops, you didn't see that. The screen switches off." /></a> <br/> <em>v2.2.0 · The Sentinel is out. Irina still works on her harnesses · <a href="https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/blob/main/assets/teaser-v2-harness.mp4">watch with sound</a></em>

<br/>

⭐ Useful to you? A star on this repo helps other people find it.

<br/>

<!-- RELEASE REMINDER: these badges are static, nothing updates them. At every release, bump by hand: version, Electron, React, the Download button below, and the "Runtime:" line of the Stack section. -->

Image: CI Image: HOL Guard scan Image: TypeScript Image: Electron Image: React Image: Tests Image: Mnemosyne OS Benchmark Image: License Image: Interface languages Image: version

<br/><br/>

<!-- Download + MnemoForge badges: auto-updated by `.github/workflows/sync-readme-release-badges.yml` on Release (tags `v…` = OS setup, `cli-…` = CLI). -->

Image: Download Mnemosyne OS Image: MnemoForge CLI

<br/>

🔏 Every installer above is cryptographically attested to this exact repo, workflow and commit, via GitHub Artifact Attestations (Sigstore-backed build provenance). Don't take the download on faith: verify the file you got matches what our CI actually built:

gh attestation verify Mnemosyne-OS-Infinity-Setup-x64.exe -R Mnemosyne-OS/Mnemosyne-Neural-OS

<br/>

Image: Audit our benchmark yourself Image: Documentation

<br/>

🌐 mnemosyne-os.io, the product, for builders&ensp;·&ensp;mnemosyne-os.com, the company, press & labs&ensp;·&ensp;📖 docs.mnemosyne-os.io, the user guide

<br/>

<img src="assets/strip-specs.png" width="100%" alt="100% local, your memory never leaves your machine · 8 GB RAM to start, 32 GB to run all local · 7 languages, EN FR ES DE PT RU ZH · Windows, macOS, Linux, code-signed builds, auto-update" />

</div>


IMPORTANT
🛡️ New in 2.2.0 · The Sentinel. Lock your screen and your avatar watches over it: a noise, a movement or a hand on the keyboard, and it reacts. Unlock with your code, Windows Hello or Touch ID. Your IDE talks better with Mnemosyne OS (Settings › Harness), git repos are sorted before they are read, and projects mapped by graphify open in a Code graph window.

→ The release notes · Connect your coding agent

<div align="center"> <a href="https://mnemosyne-os.io/hermes"><img src="https://raw.githubusercontent.com/Mnemosyne-OS/MnemoHermes/main/docs/tour.gif" width="80%" alt="The MnemoHermes cockpit opening from the Mnemosyne OS dock, then its Tasks, Agents, Tools, Skills, Memory inbox and Settings tabs" /></a> </div>

TIP
📖 The user documentation is live at docs.mnemosyne-os.io, with every engine explained step by step, in English · Français · Español.

For developers

🔌 Give your coding agent a memorynpx -y @mnemosyne_os/mcp connects Claude Code, Cursor or Claude Desktop to your vaults. Setup guide
🧩 Build an app on the memoryCopy the cartridge boilerplate for an app inside the Mnemosyne window, or run npm create @mnemosyne_os/app for a separate program (a Layer 2 app). Build on Mnemosyne OS
📖 Learn from real cartridgesTheir full source is public. Clone one
🧠 Index your agent's own notesPoint a vault at .claude, .cursor or .aider. Two doors between your IDE and your memory

🌍 Fully multilingual: the OS speaks your language

The entire interface is localized in seven languages: onboarding, settings, chat, the voice assistant, every dialog. Switching language even re-selects the ★ recommended embedding model for it, so retrieval quality follows your language, not just the labels. Open windows pick the change up instantly.

LanguageStatus
<img src="assets/flags/en.svg" width="24" height="16" alt="English flag" />EnglishYour memory. Your machine. Your rules.Stable
<img src="assets/flags/fr.svg" width="24" height="16" alt="Drapeau français" />FrançaisTa mémoire. Ta machine. Tes règles.Stable
<img src="assets/flags/es.svg" width="24" height="16" alt="Bandera de España" />EspañolTu memoria. Tu máquina. Tus reglas.Stable
<img src="assets/flags/de.svg" width="24" height="16" alt="Deutsche Flagge" />DeutschDein Gedächtnis. Deine Maschine. Deine Regeln.Beta
<img src="assets/flags/br.svg" width="24" height="16" alt="Bandeira do Brasil" />PortuguêsSua memória. Sua máquina. Suas regras.Beta
<img src="assets/flags/ru.svg" width="24" height="16" alt="Флаг России" />РусскийТвоя память. Твоя машина. Твои правила.Beta
<img src="assets/flags/zh.svg" width="24" height="16" alt="中国国旗" />中文你的记忆。你的机器。你的规则。Beta

Sovereign, local-first memory, in your language: un système d'exploitation de mémoire souverain et local · un sistema operativo de memoria soberano y local · ein souveränes, lokales Gedächtnis-Betriebssystem · um sistema operacional de memória soberano e local · суверенная локальная операционная система памяти · 主权的本地优先记忆操作系统.


Not another agent-memory library

Mem0, Zep and Letta give agents a memory layer you wire into a cloud stack.

Mnemosyne OS is the control surface for your memory, your agents and your models, and it runs on your machine. You choose which model may read your memory, and a human governs it. On LongMemEval-M holdout questions, never used to tune the engine, it scores 77.1% in hybrid mode: embeddings and search on your machine, answers from a cloud model, gemini-3.8-flash (audit it yourself).

The AI that remembers you, not infrastructure you plug into someone else's.

Where the project lives

Published by XPACEGEMS LLC. These are its official addresses:

Productmnemosyne-os.io
Organizationsmnemosyne-os.com
Documentationdocs.mnemosyne-os.io
Sourcethis repository
Packagesthe npm scope @mnemosyne_os: the list

Why call it an "OS"?

Not because it has a kernel or drivers. Because it does what an OS does: it manages resources on behalf of processes that shouldn't have to manage them themselves. Linux does that for programs (CPU, RAM, disk, network). Mnemosyne OS does the same thing for AI agents, and the resources are just different:

An agent needsMnemosyne OS manages it via
MemoryVaults, SQLite + vector stores, partitioned by domain, with AES-256 encryption at rest you arm
ContextChronicles + semantic retrieval, the agent never rebuilds its past by hand
ComputeRouting across model tiers (budget/standard/premium, local/cloud) by task complexity
HardwareReal GPU/CPU dispatch for local speech (CUDA detection, isolated sidecars) so a heavy model never blocks the app
I/OA signed intent protocol (query / ingest / forget / focus) instead of raw reads and writes
SecurityFGAC, scoped JWTs, Zero-Trust IPC validation
PersistenceCross-session continuity, no cold start on every invocation

This isn't a marketing stretch invented for this repo. MemGPT (Packer et al., UC Berkeley, 2023, arXiv:2310.08560) proposed the same "OS for LLMs" analogy in a peer-reviewed paper, virtual context management modeled on OS memory hierarchies. Mnemosyne OS takes that same premise further: not a single-session context-paging technique, but a system that runs continuously, isolates multiple agents, and persists on the machine as a daemon, not a library you import and lose on exit.


The flagship app: Mnemosyne OS Infinity Edition

The reference application of the ecosystem: a local-first AI Operating System that puts a sovereign memory core under strict user control. It runs LLMs locally or in the cloud, keeps every encrypted vault on your machine, and, for agent-to-agent sync, can speak over a libp2p transport (@mnemosyne-workspace/mnemosync-p2p).

Unlike fragmented AI wrappers, Mnemosyne OS never exposes your knowledge vault indiscriminately. Every agentic connection is governed by FGAC (Fine-Grained Access Control) and 400 Zod-validated IPC channels, ensuring total sovereignty over what executes, what's stored, and what syncs.

Core Modules
ModuleDescription
🧭 Neural MapYour memory rendered as a living mathematical topology, nodes are memories, edges are semantic similarity between them, tuned live
🧩 MnemoHubA store of cartridges (mini-apps) whose catalog is signed by a sovereign wallet and verified client-side before anything renders
💤 Dream StateA consolidation engine that replays and links memories during idle phases
🗄️ VaultsMemory partitioned by life domain, each with its own protection level and consent boundary
🎙️ Voice AssistantLocal or cloud speech, streaming STT/TTS, gapless local playback
💬 Multimodal ChatText, voice, and file-grounded conversation with live retrieval from your own vaults
🧠 Adaptive RAGRetrieval depth and ranking scale to the model you're running, laptop LLM to frontier cloud model
🔑 Sovereign Wallet & Engramm LicenseA local Web3 wallet drives licensing (verified on Base), pseudonym claims, and cloud credits, no account, no password, no gas fees
🎨 Spatial CanvasWidgets live on a 2D canvas, not stacked tabs, position carries meaning
🛩️ Agent control roomYour coding agents appear as cards on the canvas, through herdr. A risky command waits for your approval on a card
🖐️ Voice and gesturesTalk to the orb, or move windows with your hands through your webcam (beta). Speech and hand tracking run locally
📚 Memory cartridgesPublic knowledge fetched from its official source into your memory: laws, medicine, science, world history, known vulnerabilities, trademarks
🕸️ Synaptic P2PPair your machines on your local network, share a vault read-only or keep one together (beta)
Under the hood: the engines

<img src="assets/strip-engines.png" width="100%" alt="Spine engine, memory, semantically classified · Adaptive RAG, retrieval that shifts gears · Dream State, consolidation while you sleep · Voice engines, local STT and TTS, GPU or CPU · Embeddings, cloud, local ONNX or Ollama" />

Not one big "AI" black box. Several independent, purpose-built engines:

  • Embedding engine: a priority-ordered chain of embedding providers (cloud, local ONNX, Ollama). Tries each in order and fails loud rather than returning a null vector, a failed embedding must never silently become an invisible memory.

  • Retrieval engine: an in-RAM, decrypted vector cache (int8-quantized to scale), ANN search unioned with exact term matching before the final re-rank pass.

  • Spine engine: classifies every memory by semantic nature (its "spine" + tags), from a taxonomy that lives as data, not hardcoded logic, so new categories don't require a code change.

  • Dream State: two-speed consolidation. A fast, low-latency tier extracts facts during active use; a heavier tier runs at idle/night to resolve contradictions and link memories across sessions. Output is appended alongside raw retrieval, never silently replacing it. See the benchmark results below.

  • Adaptive RAG (the "gearbox"): rather than injecting every retrieved candidate, context selection (top-k / MMR / low-discrepancy sampling) scales to both the model tier you're running and the thinking mode you pick.

  • Theia, the vision engine: named for the Titaness of sight, who in the myth is Mnemosyne's sister. A complete image-memory engine: your images are embedded 100% locally (SigLIP 2, in an isolated sidecar) into their own vector space, recalled in chat as thumbnails through three rank-fused channels: semantic, pixel-color palette, and emergent categories the engine discovers on its own, and browsed in a living gallery. The human always outranks the model: rate, pin, describe, teach, rename or merge its categories. Honest by construction: a cold or still-indexing engine says so, instead of inventing "no matches". Off by default, behind one Settings toggle.

  • Voice engines, STT and TTS, fully independent: speech-to-text runs small models in-process and large models in an isolated GPU/CPU sidecar (a big STT model loaded in-process can crash the whole app); text-to-speech runs system, cloud, or local (offline binary or GPU voice cloning), scheduled sample-accurately for gapless playback. No NVIDIA GPU → automatic CPU fallback, never a hard block.

  • 400 Zod-validated IPC channels connect all of the above to the UI, auto-generated and checked by a drift test on every build.

📄 Deep dive: The Resonance Engine, technical whitepaper. The full architecture behind these engines: why memory should resonate rather than be looked up, how consolidation and adaptive selection work, and the LongMemEval results, kept current as the engine ships.

📚 Full documentation: the user guide lives at docs.mnemosyne-os.io; concepts, architecture, governance, and design decisions live in doc/.

How memory works
flowchart LR
    A["Document · conversation · file"] --> B["Vault<br/>domain-isolated, graduated protection"]
    B --> C["Chronicle<br/>content + semantic type + embedding vector"]
    C --> D["Semantic retrieval (RAG)"]
    D --> E["query() / ask()"]
    F["Dream State<br/>cold consolidation"] -. replays & links .-> C

    style B fill:#1a1a2e,stroke:#7c3aed,color:#fff
    style F fill:#1a0e1a,stroke:#ff6b9d,color:#fff
Proven on LongMemEval-M: not just a pitch
77.1 % (37/48)48 holdout questions, never used to tune the engine, full-haystack (hard) variant, official LongMemEval judge, September 2026
85.4 % (41/48)the 48 questions used to tune the engine, strict judge
Two passesa question counts only when both passes get it right
Every answerpublished with every raw judge reply, and a verify.js that recomputes each figure

LongMemEval is a public, independent long-term-memory benchmark. Its full-haystack variant surrounds every question's evidence with ~480 distractor sessions, the closest published setup to a real, lived-in memory vault, and harder than the -S slice most reported numbers use.

The protocol was published before the run. The holdout questions had never been answered before. The run uses the hybrid mode: embeddings and search run on the machine, and a cloud model, gemini-3.8-flash, writes the answers. It measures the SDK and MCP door that agents use.

In September an outside audit by Julien Gelee found a wrong verdict in our August result. It covered the published files, ledgers and arithmetic, and did not evaluate the product or the closed engine. The erratum corrects it to 35/48 (72.9 %) under the strict judge and 37/48 (77.1 %) under the flexible one. We then ran the whole benchmark again. July's composed 72.9 % stays archived under its DOI. The reader, the engine and the judges changed between these runs, so the figures sit side by side and never chain into a progression.

Don't take any of it on faith. Audit it. The published grader and per-question verdicts let you re-derive every score in one command, no engine and no network. Full methodology, root-cause analysis, and the raw run logs of both campaigns are public too:

🔍 Audit it yourself: every answer and a verify.js →  ·  live results page  ·  raw logs & methodology

Citing this work. Both the evidence and the architecture are archived under permanent identifiers, so they can be cited rather than merely linked:

Verification kit, ledgers, grader, raw logs10.5281/zenodo.21727140
The Resonance Engine, technical whitepaper10.5281/zenodo.21728283
AuthorTony Trochet · ORCID 0009-0009-1087-3917

<br/>

<div align="center"> <img src="assets/infinite-canvas.jpg" alt="The infinite canvas, an endless plane with the gallery, MnemoHub, chat, world clocks, weather and stickers, zoomed to 26%" width="820" /> <br/> <em>The infinite canvas (v1.4.0): pan the void, zoom 10%–100%, and make the plane yours, the image gallery, MnemoHub, diagnostics, world clocks, weather and stickers, all living on one endless surface</em> <br/><br/>

<img src="assets/infinite-canvas.gif" alt="Thirteen seconds of the infinite canvas, panned, zoomed and decorated live" width="820" /> <br/> <em>Thirteen seconds of the real thing, the canvas panned, zoomed and decorated live · <a href="https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/blob/main/assets/infinite-canvas.mp4">watch in higher quality</a></em> <br/><br/>

<strong>Turn memory on for your images.</strong> One Settings toggle gives your vaults an eye: drop in a folder of photos and <strong>Mnemosyne OS remembers every image you add</strong>: indexed 100% locally, organized in a living gallery you can rate, pin and teach, and recalled in chat: ask for <em>"the pieces that look like a blue cup"</em> and your own photos answer. <br/><br/><br/>

<img src="assets/neural-map.jpg" alt="Neural Map, topology-driven memory graph" width="820" /> <br/> <em>Neural Map: your vault rendered as a living mathematical topology, Enneper surface, Klein bottle, Lorenz attractor, Clifford torus… the equation <strong>is</strong> the shape</em> <br/><br/><br/>

<img src="assets/neural-map-torus.jpg" alt="Neural Map, torus topology" width="820" /> <br/> <em>Every node is a memory, every edge a measured semantic link, here the same graph wound onto a torus, tuned live</em> <br/><br/><br/>

<img src="assets/ai-configuration.jpg" alt="AI Configuration, multi-model, local or cloud" width="820" /> <br/> <em>Multi-model by design: run memory 100% local, cloud, or hybrid, Gemini, Claude, OpenAI, Groq, Mistral, DeepSeek, Ollama</em> <br/><br/><br/>

<img src="assets/mnemohub-store.jpg" alt="MnemoHub, build, sign and publish a cartridge" width="820" /> <br/> <em>MnemoHub: build a cartridge on the SDK, sign it with your sovereign wallet, and publish it to the ecosystem</em> <br/><br/><br/>

<img src="assets/sovereign-notes.jpg" alt="Sovereign Notes" width="820" /> <br/> <em>Sovereign Notes: write in a local, classified vault, every note is embedded and retrievable, feeding the same memory your agent draws on</em> <br/><br/> </div>


Two doors between your IDE and your memory

You already run an agent next to your editor. It opens every session without the history of the project it is working in, so it reasons its way back to conclusions you reached weeks ago, and it will do that again tomorrow. Part of that history survives: the agent wrote it down itself. It sits in a dot-directory beside the code, usually gitignored, read by nothing.

Mnemosyne OS opens two doors onto it, and they run in opposite directions.

Door one, memory reads the agent. DocWatch watches a folder you deliberately point at, whatever its name, so .claude/…/memory is treated like any other source and what your agent noted becomes retrievable next to your documents and your code. Shipped in v1.4.3: before that a blanket ignore rule dropped every dot-directory, in silence.

→ Connect your coding agent's memory

Door two, the agent reads memory. @mnemosyne_os/mcp is a Model Context Protocol server: one entry in your client config, and the agent can search a vault, ask it a question in prose, and write back what it worked out.

npx -y @mnemosyne_os/mcp

→ Connect Claude to Mnemosyne OS (MCP)

Three of those tools need neither the app, nor a vault, nor a single token: they read the transcripts your harness already writes to disk. That is what makes "is another session live on this branch before I commit?" cheap enough to actually ask.

The mechanism is the whole claim. We publish no measurement of what this saves in tokens or in minutes, so we assert none. Retrieval is not reasoning: a decision a model can look up is a decision it does not derive a second time, and the context it would have spent reconstructing where it is goes to the task instead. Watch it in your own sessions rather than taking a number for it.


Build on Mnemosyne OS

You've seen what it is and that it works. Now build on it. Your apps, agents, and skins talk to the private AI memory runtime through a public Gateway contract: a stable, documented surface you build against, while the Cognitive Core stays sealed and never exposed.

Two ways in:

  • 🛠️ Build on it: copy the cartridge boilerplate for an app inside the Mnemosyne window, or scaffold a separate program and you're talking to the memory vault in minutes.

  • 💾 Run it: install the flagship desktop app, Infinity Edition.

npm create @mnemosyne_os/app   # a Layer 2 app: a separate process, not a cartridge
PackageWhat it does
@mnemosyne_os/cartridge-sdkBuild a cartridge: an app inside the Mnemosyne window, in a sandboxed iframe
@mnemosyne_os/sdkConnect a separate program (a Layer 2 app) to the local AI memory runtime (WebSocket / Electron IPC)
@mnemosyne_os/public-contractsShared types & Zod schemas, the integration contract
@mnemosyne_os/design-sdkBuild custom UI skins in pure JSON, zero TypeScript
@mnemosyne_os/create-appScaffold a Layer 2 app in one command. Not a cartridge: MnemoHub refuses to link it

Start from the cartridge boilerplate and you're ingesting and querying the vault, under FGAC, scoped, and consent-gated, in minutes.

🛡️ Zero-Trust by design. Every SDK connection authenticates with a short-lived JWT, listens on 127.0.0.1 only, and is bounded by the scopes your app manifest declares. The OS sees your requests; you never see the core.

The cartridges are real, and readable

The apps in MnemoHub aren't black boxes. Each ships its actual src/ (React + the SDK), public and inspectable. Clone one as a reference implementation and read exactly how a real app connects to the memory runtime, ingests, and queries the vault through the SDK. Don't learn the SDK from API docs alone, download a working app and copy the patterns. A few live examples:

CartridgeWhat it isClone it to learnLicense
MnemoArchipelThe sovereign, offline-first personal CRMsemantic relationship maps + custom node coordinates over the vaultCartridge License · source-available
MnemoRestoA full restaurant suite, POS, reservations, tips, per-product VAT, inventorystructured business data persisted in scoped vaultsCartridge License · source-available
BMAD 2.0A wizard that turns an idea into a structured project blueprinta multi-step flow that reads and writes the vaultCartridge License · source-available
MnemoReaderA living PDF library that reads aloud with word-synced highlightingdocument ingestion + streaming local TTS through the SDKMIT
TranslatorBatch-translate text & Markdown with your own AI keybringing your own AI key + batched runtime callsMIT

MIT cartridges are yours to fork and ship anywhere. The Cartridge License is source-available: read it, learn from it, modify it, with one condition: it runs inside the Mnemosyne OS ecosystem.

🧩 Make your own. Scaffold a cartridge from the boilerplate, build it against the SDK, and publish it to MnemoHub, exactly how these were made. From npm create to a signed, installable cartridge, the whole path is yours.


The open ecosystem

The open surface of Mnemosyne OS is MIT-licensed and free to build on:

  • Layer-2 SDK (/packages) is the integration surface above: connect apps, build skins, scaffold projects, evaluate against the Gateway.

  • MnemoForge CLI (/cli) is a separate developer tool with its own docs: see cli/README.md. To give a coding agent memory, use the MCP server instead.


Why it's safe to build on

The open SDK and the sealed core are separated by a single boundary: the Gateway. Apps speak a public contract; the core's internals are never shipped to, or reachable from, third-party code.

flowchart TB
    subgraph Renderer["Renderer Process (React)"]
        UI["React 18 · TypeScript strict · Vite<br/>i18next (EN/FR/ES) · 30+ lazy-loaded routes"]
    end

    subgraph Bridge["contextIsolation: true · nodeIntegration: false"]
        CB["Context Bridge<br/>400 Zod-validated IPC channels"]
    end

    subgraph Main["Main Process (Electron)"]
        SVC["Services: AI · Vault · Drive · Workspace<br/>Shadow · Window · Network · FGAC · Scheduler"]
    end

    subgraph Net["Sovereign network (127.0.0.1 only)"]
        SDKWS["SDK WebSocket"]
        MCP["MCP server"]
    end

    subgraph Chain["Base L2, on-chain"]
        ENGRAMM["Engramm License"]
    end

    UI <--> CB
    CB <--> Main
    Main --> SDKWS
    Main --> MCP
    Main -. verify via Gateway .-> ENGRAMM

    style Main fill:#1a1a2e,stroke:#7c3aed,color:#fff
    style Renderer fill:#0f172a,stroke:#38bdf8,color:#fff
    style Chain fill:#1a1a0e,stroke:#f39c12,color:#fff
The Engramm License

Running Mnemosyne OS is unlocked by an Engramm, named after the engram, the physical trace a memory leaves in the brain. Fitting for a memory OS: it's your own verifiable trace of ownership.

Rather than an account and a monthly subscription, your license lives on-chain (Base), bound to your wallet, not to a machine, not to an email. You hold it, so you own your copy and carry it to any device you want, and anyone can verify it. The same Engramm drives your sovereign pseudonym and cloud credits. Holding it and checking it cost you nothing. See below.

Auth: cold boot / warm boot

A local wallet is the only credential. No account, no password server-side to breach.

No gas fees, no crypto to manage. The chain is plumbing, not a paywall. You never pay a network fee, hold a token, or approve a transaction. Ownership is recorded on Base so it stays publicly verifiable, but every network cost is covered for you. A wallet you never have to think about.

sequenceDiagram
    participant U as "You"
    participant W as "Sovereign wallet (local)"
    participant G as "Gateway"
    participant C as "Base L2 (chain)"
    participant T as "OS keystore"

    Note over U,T: Cold boot (first launch / new machine)
    U->>W: launch the app
    W->>G: signed challenge
    G->>C: verify Engramm on-chain
    C-->>G: does this wallet hold the license?
    G-->>W: signed verdict

    Note over U,T: Arming encryption at rest, separate, and up to you
    U->>W: turn on encryption at rest
    W-->>U: 24-word recovery phrase, confirm it
    U->>W: confirmed
    W->>T: seal the AES-256 key

    Note over U,T: Every launch after
    W->>T: read the sealed key
    T-->>W: key → vaults open encrypted

    Note over W,T: Once armed, physical theft = encrypted SQLite.<br/>Until armed, vaults are local but in cleartext.

Security-first Electron architecture

  • contextIsolation: true, nodeIntegration: false on every window

  • sandbox: true for web content, relaxed only for the local-AI worker threads, mitigated by context isolation + Zod-validated IPC

  • Explicitly declared IPC methods via Context Bridge, validated with Zod + audit logging

  • Strict Content Security Policy

  • Windows builds code-signed (Certum OV, RFC-3161 timestamped); every release binary carries a Sigstore build-provenance attestation tying it to the exact CI run and commit that produced it

Sovereignty enforced in code

  • FGAC governs exactly what an agent, or a third-party app, can read, write, or sync

  • 24h TTL on access grants, auto-healing on refresh

  • P2P Shadow Sync with alert system and OS notifications

  • No telemetry without consent

Stack

  • Runtime: Electron 43, Node.js 24

  • Frontend: React 18, TypeScript (strict mode), Vite

  • State: Zustand with useShallow atomic selectors

  • AI Integration: Claude API, Ollama (local LLMs), OpenAI-compatible endpoints

  • Testing: Vitest + Testing Library, green CI gate

  • CI/CD: GitHub Actions, typecheck + lint + i18n validation + tests


Open-core & Licensing

Mnemosyne OS follows an open-core model: an open, MIT-licensed developer ecosystem built around a proprietary core.

ComponentLicenseDescription
Developer SDK (/packages/*)MITOpen, build apps, agents & skins on Mnemosyne OS
MnemoForge CLI (/cli)MITFree to use, modify, and redistribute
Mnemosyne Neural OS (platform)Proprietary© 2026 XPACEGEMS LLC, All rights reserved

The SDK and MnemoForge CLI are MIT licensed. Fork them, build on them, ship your own apps. The root LICENSE file is the plain MIT text and covers cli/, packages/, examples/ and handbook/; the desktop application is not covered by it. The Mnemosyne Neural OS platform, the desktop application, Neural Map, MnemoHub, Dream State, Vaults, and associated services, is proprietary software. No part of the platform may be copied, modified, or distributed without explicit written permission from XPACEGEMS LLC.

End-user licensing is separate from the code license above. Running Mnemosyne OS is unlocked per user by the Engramm, an on-chain license bound to your wallet, not a subscription, while the SDK and CLI you build with stay MIT.

Why the core is closed. Everything you need to build is open; what stays sealed is the part that took years of full-time R&D to get right, the memory engines (Spine, Retrieval, Dream State) behind the LongMemEval numbers above. Keeping that core proprietary is what lets an independent lab sustain the project, fund the open ecosystem around it, and grow a team, instead of handing a hard-won engine to anyone who would re-skin it. The trade is deliberate: everything above the Gateway is yours to fork; the engine that makes it worth building on stays ours.

For licensing inquiries: [e-mail address on the upstream page](mailto:e-mail address on the upstream page)


Quality

TypeScript errors     : 0   (strict mode, noUncheckedIndexedAccess)
ESLint warnings       : 0
Test suite            : Vitest + Testing Library (green CI)
CI pipeline           : ✅ Green (typecheck → lint → i18n → tests)
Languages             : 3 (EN / FR / ES)
i18n namespaces       : 47
Electron security     : context isolation · Zod-validated IPC · CSP

Development Philosophy

Mnemosyne OS is built on three principles:

1. Sovereignty: Your data stays local. Your models run locally if you choose. No telemetry without consent. FGAC controls what the AI can and cannot access.

2. Multi-model: No vendor lock-in. Claude, GPT, Gemini, Groq, Mistral, DeepSeek, and MiniMax in the cloud; Ollama or a local GGUF model fully offline; any OpenAI-compatible endpoint on top. Switch per task, or let the app route automatically.

3. Agentic by design. This is not a chat interface with file upload. A real orchestration layer where multiple AI agents coordinate, with policy enforcement and audit trails.


🔬 Mnemosyne Labs: research, activated

<img src="assets/labs-activated.png" width="100%" alt="Mnemosyne Labs, open research program. Research, activated. Open methodology, auditable benchmarks, artifacts archived with a DOI, cite the work, audit the claims." />

The numbers above come from published, citable research artifacts. Mnemosyne Labs is the research arm of the project: methodology in the open, benchmarks anyone can audit, artifacts archived with a DOI.

ArtifactDOI
📄 The Resonance Engine: technical whitepaper v2.1: the architecture behind the engines, consolidation, adaptive selection, the hybrid lexical channel, and the LongMemEval resultsImage: DOI
🔍 LongMemEval-M audit kit: the scorer, per-question verdicts and honest methodology, packaged so you can audit the claims yourself. This DOI pins the July deposit (the 72.9% campaign); the live kit also recomputes the August oneImage: DOI

Both records are open access (CC BY 4.0), cite each other on Zenodo, and are bound to the founder's research identity, ORCID 0009-0009-1087-3917.

→ Mnemosyne Labs · → How to cite this work · → Live audit page


Roadmap

Shipped
  • [x] 🚀 Infinity Edition, 30 public releases, now at v2.2.0 · The Sentinel

  • [x] 🖼️ Theia, image memory and visual recall: Mnemosyne's sister engine (named for the Titaness of sight) gives every vault an eye: your images are embedded locally (SigLIP 2, no cloud, no API), recall answers with thumbnails under the reply, and a living gallery shows them with categories the engine discovers on its own: categories you can rate, correct, rename or teach, because the human's word always outranks the model's guess. Off by default; one Settings toggle installs, downloads pinned weights and indexes.

  • [x] 🕸️ Synaptic P2P (beta, since v1.5.0): two installs connect directly over libp2p, with no cloud relay. Give someone a vault to read, send mail between installs, keep one vault together, and give each of your machines a role

  • [x] 📚 Memory cartridges: public knowledge fetched from its official source into your memory, starting with laws, medicine, science, world history, known vulnerabilities and trademarks

  • [x] 🖐️ Voice and gestures (v1.7.0, gestures out of beta in v1.8.0): drive the canvas with your voice and your hands

  • [x] 🧩 MnemoHub: signed cartridge marketplace, community submission pipeline, live publishing

  • [x] 🪪 Sovereign identity: claim a public pseudonym bound to your wallet, no account, no password

  • [x] 💤 Dream State: a consolidation engine that replays and links your memories while you're away

  • [x] 🗜️ Octave, multi-resolution memory compression: the engine behind the compression milestone, aboard since v1.3.8: while you're away, consolidation prepares each memory at several resolutions, so the answer path can carry more memory into a small context window. Strictly extractive: every compressed line is a verbatim excerpt of the original, provable by character offsets, never a paraphrase: and compressed derivatives inherit the exact vault protection of their source. Serving them on the answer path stays off by default until the full benchmark campaign clears it.

  • [x] ⚡ MnemoForge CLI v1.4.7 on npm, @mnemosyne_os/forge · Soul Protocol · Canvas Rules · Chronicle System · MCP Server

  • [x] 🌱 Public beta, v1.1.0-beta.1: where it started (personality-profile builder, semantic memory graph, first-contact onboarding)

What's next
  • [ ] 🗜️ Context compression, on by default: the Octave engine is already aboard (see Shipped). While your machine is idle, every memory is prepared at several resolutions, strictly extractive, offset-provable, never a paraphrase. What remains is serving those compressed forms on the answer path for everyone, gated behind the full measurement campaign, so a lifetime of accumulated memory stays cheap to carry into the small context windows of on-device models. Memory that keeps growing must stay cheap to carry, this is what keeps Mnemosyne sovereign on modest hardware.

  • [ ] 📱 Mobile companion app: take notes and reach Mnemosyne OS running on your desktop remotely. Capture on the go, sync back into your local vault, chat with your own memory away from the machine

  • [ ] 👥 Team features: memory shared across a whole team, beyond one shared vault

  • [ ] 🖥️ Self-hosted sync server

  • [ ] 🕸️ Permaweb archival: pay-once, permanent memory storage on Arweave, no subscription and no server that can disappear. Psyche (souls for any AI agent) is the vehicle; bringing it into Mnemosyne OS as a cartridge is the path to making permanent archival a native option for chronicles, and eventually vault backups

  • [ ] 💰 Creator economy, paid visibility for cartridges, revenue flowing back to builders


About

XPACEGEMS LLC, Independent AI software lab
Headquarters: 2932 NW 72 AVE, Miami, FL 33122, USA
Founder & Lead Architect: Tony Trochet
Product: mnemosyne-os.io: downloads, docs, build on it
Company: mnemosyne-os.com: press, research, Labs
Documentation: docs.mnemosyne-os.io: every engine, step by step
LinkedIn: Tony Trochet
GitHub: @yaka0007

Built through Neural Coding, human-architected, with Claude (Anthropic), Antigravity (Google DeepMind), and Cursor directed as instruments.


📰 What's new

A new build ships most weeks. Windows builds are code-signed (Certum OV, RFC-3161 timestamped) and auto-update once installed.

DateReleaseIn one line
Nov 9, 2026v2.2.0 · The SentinelSentinel gets a face: your avatar watches the locked screen on every display, unlock by code, Windows Hello or Touch ID. Settings › Harness shows what your AI receives on each turn. Git repos are sorted into docs, code and history vaults before they are read. Compatible with graphify (a Code graph window). Hermes Agent 0.23 with the Mnemosyne OS plugin. In test: a local decision model checks the orb's voice commands.
Nov 5, 2026v2.1.0 · The Local ModelLFM3 from Liquid AI is the new default local model: 1.1 GB, it runs without a graphics card. A review widget your coding agent drives over MCP. The Notion connector imports a whole workspace into a vault. Translations reviewed in German, Russian, Chinese and Portuguese. Onboarding saves the « 100 % local » and credits choice.
Oct 31, 2026v2.0.0 · The AvatarThe Avatar Studio: a face, a voice and a personality on every desktop. New onboarding (run it again from What's new; your settings are kept). XTTS is replaced by Qwen3-TTS on the GPU, free. Wake word and voice-first mode. Agenda and To-do redone. Lab 3D, MnemoBudget and MnemoSign. Up to 3 desktops without a license. Many features are still experimental.
Oct 17, 2026v1.9.0 · The OrbThe orb becomes your assistant. She drives your apps: say "tidy my desktop" and she plans the steps and runs them, on the board, on an empty desktop or pinned above all your applications. She now also understands German, Portuguese, Russian and Chinese. Your day comes to the board: the morning briefing and the evening journal read aloud, Google Calendar and your mail, meetings prepared on a card, and Sentinel, an alarm for your desk while you are away. Your coding agents drive Mnemosyne OS from Claude Code, Cursor, Codex or any IDE connected to the MCP server, and every call is written to a journal on your machine. Also new: IDE Timeline, YouTube in an app (beta) and memory on an NVIDIA card (beta). Many features are still experimental.
Oct 8, 2026v1.8.0 · The LibraryThe knowledge memories open. Knowledge apps in the MnemoHub download public knowledge into vaults of their own: laws, history, health, science and languages. You ask the chat, and it answers from them. Hand gestures are out of beta. Every app in the Hub has its own page, with photos, reviews and its version, and a Dev section plugs Claude Code, Codex, Antigravity or Cursor into your memory. Ask the chat about a period, and MnemoClio opens on that year. Also new: apps on a desktop of their own, starter questions in an empty chat, the weather from the orb, and spending split by route in the wallet.
Oct 2, 2026v1.7.0 · The HandsYou can now drive your board with your hands, through your webcam (beta). Pinch a window’s corner to move it, spread your fingers for full screen, or hold a fist to close it. A second pass can check a chat answer against its sources. Your coding agents appear as cards on your board, through herdr. Also new: web search through Hermes, formulas in the chat and layers in the image studio. And an arcade on the neural map, data widgets (beta) and larger local models.
Sep 23, 2026v1.6.0 · The AssistantMnemosyne OS can now run an assistant that works for you. Hermes Agent installs in one click (beta) through the MnemoHermes cartridge, reads your memory, and answers you on Telegram, by voice if you like. Before a risky command, it asks you on a card on your board, and you answer once, for the session, or always. Voice notes are transcribed on your machine. Say "Hermes, …" to the orb and it hands the request over. Exact-word search now reads seven languages, and a file name in your question finds that file. Also new: OpenRouter as a provider, Tailscale in the P2P screen to reach a peer on another network, and every call listed in the wallet.
Sep 19, 2026v1.5.1 · The Key Found AgainA fix for Mac. Changing network renamed the machine, and the sovereign wallet closed with your credits inside it. The app now finds the key again at startup and reseals it, and the offline licence holds through the same rename.
Sep 18, 2026v1.5.0 · The SynapseTwo installs can now connect. Synaptic P2P (beta) gives someone a vault to read, sends courier mail and shares one vault that several people write. You can tell the app what to do, spoken to the orb or typed in the chat: "open my agenda", "full screen", on any window, in your language, plus the phrases you teach it in Settings › Commands. The recorder transcribes with timestamps and recognises your enrolled voice. Also new: a memory health panel, an ask line on a blank desktop, external shortcuts pinned on the board, agent cards in the cockpit, the chat acting on your agenda and backlog, and MCP 2.0 with a one-click install for Claude Desktop. More than 500 commits since 1.4.5, more than 200 of them fixes.
Sep 8, 2026v1.4.5 · The Locked DoorA repair release that grew a beta. The headline is a lock: only a cartridge you linked yourself in developer mode can start a script on your machine: a Hub cartridge could declare a development address and run its script the moment its window opened, so every install on 1.4.4 or earlier should take this one. Behind it, a zone-by-zone pass of 650 commits and 285 fixes: the chat answers in under a second instead of freezing for a minute, it searches by exact words again (the lexical channel had only ever served the SDK, not the chat), the Dream State dreams a whole topic instead of its first forty pieces, a watched-folder rule applies to that folder alone, and every number nobody measured reads unknown instead of 0. New: drive the board with your hands (Settings › Gestures, beta, pinch to grab, two hands to zoom, swipe), a conversation recorder that keeps you and the other side on two tracks with no speaker model, a portable cartridge that carries a memory to another machine on a drive, « Ask » in the capture browser to question your memory about the page you are on, eight new MCP tools so an agent can read, change and remove your To-do and Agenda even with the app closed, words-only vaults for code, a neural map with one settings drawer and a brain figure, and an AFFiNE import.
Sep 3, 2026v1.4.4 · The Whole DocumentFor anyone who drops real documents into a vault: a long document now enters memory whole. It was cut at 18 000 characters, so a 300-page book was remembered as its first six pages. A file refused outright said nothing at all, and two 150-page courses had been turned away in complete silence; a refusal now names the file, its size and the rule it broke. PDF, Word and Excel go from 5 MB to 50 MB. For a company: point Mnemosyne at your own OpenAI-compatible model server on your own network, and the route is yours end to end. The chat reads several vaults at once, follows the vault you picked in the panel, or lets the model choose per question. Ask Mnemosyne about Mnemosyne: a manual ships inside the app in French, English and Spanish, and says plainly when it has no page on your subject. The capture browser is rebuilt for the web: every image of a page in one click, or the page as text, as a PDF, as a screenshot, all reviewed before any of it becomes memory. Plus a problem report from any window that shows you what gets sent before you send it, images pasted inside a .docx kept and indexed, and a boot that stopped rebuilding the neural map eleven times per launch.
Aug 31, 2026v1.4.3 · What Your Agent KnowsFor anyone who codes with an AI agent open beside them: your agent's memory can finally enter a vault. Every agent keeps what it learned under a dot-directory (.claude, .cursor, .aider, .continue), and a blanket ignore rule dropped all of them whole, in silence: the source read enabled, the panel showed a green dot, the log said the watch had attached, and not one file was ever ingested. A folder you deliberately point at is now watched, whatever its name. Searching through the MCP also gains the exact-word channel the app's own retrieval already had. Plus the work that piled up behind the 1.4.2 cut: desktops on the canvas (a desktop is a world, with its own windows, camera and decor), a to-do rework with lists of your own, an archive that is not a delete, drag to reorder, and tasks that leave the list to sit on the canvas and ring; notes that open in a window of their own; vaults readable from across the board; and a vault's weight that says who answers without ever stopping it from recording.
Aug 29, 2026v1.4.2 · The Clean CutCut a subject out of any image on your own machine: right-click it on the canvas, and put the background back in one click, the original file is never touched. Two permissively-licensed models, the choice yours in Settings. Image memory can now use an NVIDIA GPU, and nothing is marked upgraded without proof it booted on one. A new room for making pictures: several plans open at once, your own images as a brand kit a generation must honour, and a prompt Mnemosyne writes out of your own memory. Oikos reads the devices in your house and keeps a still of them where your memory can find it a year later, one approved device at a time, addresses you declare, polling that stops the moment you withdraw consent. And the canvas travels: opening a window flies to it, with a way back from every trip.
Aug 26, 2026v1.4.1 · The Closed PipeLinux fix: launching the AppImage from a terminal that was later closed broke standard output, and every log line then raised a fatal error dialog, one per line. The log bus now detects the closed pipe and keeps the ring buffer and the daily file, which is the path packaged builds actually use. Also, a scanned book is read whole: OCR reads a document in page windows instead of stopping at 60 pages, and says which page it is on.
Aug 25, 2026v1.4.0 · The Infinite VisionMnemosyne learns to see: Theia, a fully local image-memory engine (SigLIP 2, on-device), makes your photos recallable in chat, ask for "the pieces that look like a blue cup" and the thumbnails answer, with a living gallery (day timeline, stars, pins, and categories the engine discovers and you can correct or teach). The workspace unlocks into an infinite canvas you pan, zoom and decorate with clocks, weather and stickers; paste or drop an image anywhere and a vault picker turns it into memory; a sandboxed capture browser (beta) brings the web in, one human gesture per capture, never automatic. Plus: local models fixed on fresh installs, gapless local read-aloud, and a notes rework with a constellation view and five-colour highlights.
Aug 18, 2026v1.3.8 · The Second ChannelRetrieval gains a second, fully local channel: your vault is now also ranked by exact words (BM25 over a persistent index built inside the vault) and fused with the semantic ranking by rank, a proper noun, an identifier or a number now finds its session. Measured on LongMemEval full-haystack, strict judge: 29 → 37 of 48, reproduced twice, confirmed on held-out questions with zero regressions. Plus per-app isolation proven on every retrieval channel, and an installer with a proper trilingual EULA that launches the app when it's done. Also aboard: Octave, a multi-resolution memory-compression engine, strictly extractive, off by default on the answer path until measured.
Aug 10, 2026v1.3.7 · The Kept PromiseThe whole loop runs on your machine, model, memory and retrieval, with no key and no account. A refreshed local catalogue with 262k-token context windows (the entry-level model shipped with 4k), your own .gguf files welcome, bring-your-own-key providers that hand you their real model list, a local journal of what every call costs at your prices, and vault protection the routing now honours end to end.
Aug 3, 2026v1.3.6 · The PersonaThe OS takes your shape: four new shell languages (Deutsch, Português, Русский, 中文), abstract voice-orb skins with a full-screen mode, a user-chosen accent that cartridges inherit live, a sixteen-archetype cognitive lens that styles the voice without ever touching retrieval, and web search rebuilt.
Jul 29, 2026v1.3.5 · The Sealed VaultOpt-in AES-256 encryption at rest with a 24-word recovery phrase, backups decided by an allow-list of what is genuinely yours, and ~10 GB of machine-bound toolchain moved out of the data folder.
Jul 22, 2026v1.3.4The first code-signed Windows build, no more "unknown publisher".
Jul 20, 2026v1.3.3 · The Sovereign LedgerThe credit economy: in-app credit and license flow, a creator cockpit for cartridge builders, sovereign pseudonyms backed by a real install counter.
Jul 19, 2026v1.3.0 · The Memory CovenantThe sealed core, app-sandbox vaults with human-gated permanence, and memory-purge governance.
Jul 7, 2026v1.2.0 · The Reading EngineA PDF library that reads to you, deferred local OCR, voice reading, and the spine memory engine underneath.

→ All releases

✍️ From the blog

The longer stories behind the releases and the campaigns, on the product site:

→ All posts


<div align="center">

Memory decides who an agent stays between sessions, not whatever model happens to be running.

<br/>

Image: last commit Image: commit activity

</div>

415 files · 395 not served here

Advantages

  • Sovereign, local-first architecture ensures that sensitive memory never leaves the user's machine. evidence: README.md
  • Provides persistent cross-session memory and context, preventing agents from needing to rebuild their history. evidence: README.md
  • Supports fine-grained access control (FGAC) for secure, user-governed agent interactions. evidence: README.md

Limitations

  • The core memory engines (Embedding, Spine, Retrieval, Dream State) are proprietary and not included in the open-source repository. evidence: AGENTS.md
  • Requires the desktop application to be running to provide memory services to agents. evidence: AGENTS.md

Security

Risk level: Medium risk

This brain runs

Agent instructions that run or fetch something (16)

  • AGENTS.md: npm create @mnemosyne_os/app my-app
  • AGENTS.md: If a conversation keeps circling a tool that does not exist yet — a reader, a CRM, a dashboard over their own notes — `npm create @mnemosyne_os/app` is a real answer, and a cartridge that runs inside the OS with its theme and its permissions is a second one.
  • examples/cartridge-boilerplate/AGENTS.md: | You are building… | Surface | Client library | Transport | |---|---|---|---| | A **UI panel inside the Mnemosyne window** (a cartridge on MnemoHub) | **Cartridge** — *this guide* | `MnemoCartridgeSDK` (`@mnemosyne_os/cartridge-sdk`) | `postMessage`, sandboxed iframe | | A **separate …[+281 chars] · uses the network
  • examples/cartridge-boilerplate/AGENTS.md: ⛔ Not `npm create @mnemosyne_os/app`: that scaffolds a Layer 2 app (a separate process, no `mnemo-plugin.json`), and MnemoHub refuses to link it.
  • examples/cartridge-boilerplate/AGENTS.md: **Reference implementation to read first:** [MnemoReader](https://github.com/Mnemosyne-OS/MnemoReader---MnemosyneOS) (a real, shipped cartridge). · uses the network
  • examples/cartridge-boilerplate/AGENTS.md: The user grants them at install.
  • examples/cartridge-boilerplate/AGENTS.md: Permissions are declared in the manifest and granted by the user at install.
  • examples/cartridge-boilerplate/AGENTS.md: `vault:read` · `vault:write` · `model:infer` · `dialog:open` · `metrics:read` · `settings:read` · `settings:write` · `scout:run` · `wallet:read` · `net:lan` · `watch:background` · `hermes:control` · `cockpit:pin` · `agent:export` · `git:read` · `breach:lookup` · `agenda:write` · `feedb …[+155 chars]
  • examples/cartridge-boilerplate/AGENTS.md: `wallet:read` reads a credit balance, `net:lan` reads one device on the user's own network, `watch:background` lets the host keep polling your feeds while your window is closed, `hermes:control` drives a local agent install, `cockpit:pin` lets the user pin small status cards you publis …[+208 chars]
  • examples/cartridge-boilerplate/AGENTS.md: **Ungated actions (no permission gate — run on any loaded cartridge):** `canvas.leaveBoard`, `canvas.openBoard`, `cockpit.state`, `getStatus`, `hub.showUpdate`, `irinaHealthCheck`, `license.offer`, `license.status`, `marks.keyState`, `marks.mirrorStatus`, `orb.summon`, `permissions.ref …[+145 chars]
  • examples/cartridge-boilerplate/AGENTS.md: **Nothing types your tests unless you run `pnpm typecheck`.** The build's `tsc` excludes them on purpose, so shipping does not require vitest installed.
  • examples/cartridge-boilerplate/AGENTS.md: `pnpm typecheck` runs `tsconfig.eslint.json`, which includes everything.
  • examples/cartridge-boilerplate/AGENTS.md: | Package | Use it for | Version | |---|---|---| | `@mnemosyne_os/cartridge-sdk` | Cartridge (this guide) | 0.4.1 | | `@mnemosyne_os/sdk` | Layer 2 app | 1.5.5 | | `@mnemosyne_os/mcp` | MCP server | 1.9.0 | | `@mnemosyne_os/create-app` | Scaffold (`npm create @mnemosyne_os/app`) | 1.0.4 …[+62 chars]
  • examples/cartridge-boilerplate/AGENTS.md: Copy the boilerplate and read the [MnemoReader reference](https://github.com/Mnemosyne-OS/MnemoReader---MnemosyneOS) before writing from scratch. · uses the network
  • packages/mcp/skills/mnemosyne-review/SKILL.md: **Waiting without a loop.** If your harness wakes you when a background command ends (Claude Code: `run_in_background`), run `mnemosyne-review-wait <id> --after <after>` (shipped with `@mnemosyne_os/mcp`;
  • packages/mcp/skills/mnemosyne-review/SKILL.md: In a harness without that, run it in the foreground or keep the loop.
  • Medium risk: runs-instruction-instruction-network (examples/cartridge-boilerplate/AGENTS.md:29)
  • Medium risk: runs-instruction-instruction-network (examples/cartridge-boilerplate/AGENTS.md:520)

Attribution and licence

Created by
Tony Trochet / XPACEGEMS ECOSYSTEMS
Declared authors
  • Tony Trochet (declared in CITATION.cff)
Publisher
Mnemosyne OS (Official Mnemosyne OS project)
Source
Mnemosyne-OS/Mnemosyne-Neural-OS · commit abc525a
Licence
MIT License (files served here)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Tony Trochet / XPACEGEMS ECOSYSTEMS or Mnemosyne OS.

Install from source

395 of its files are not served here, so there is no ZIP. Mnemosyne-OS/Mnemosyne-Neural-OS at abc525a