🍎 macOS support is here — got a Mac and 15 minutes? Join the beta →
Mnemo Cortex — circuit-eye logo card

Mnemo Cortex

It's not just memory — it's cognitive coprocessing.

The big AI-memory systems run on millions in venture capital. Mnemo Cortex goes toe-to-toe with them — built by one 73-year-old maker on Social Security and a $20-a-month Claude subscription.

Cross-agent memory, overnight dreaming, portable facts, local-first privacy — free and open source, no funding round required. Fork it, rewire it, bend it to how you work — it's your memory, on your machine, in plain files. The entire business model is the tip jar.

Now with
Dreaming Mnemo

Dreaming Mnemo shares dreams across agents.

Not storage. Not memory. Not logs.

Continuity of intelligence across agents, time, and tasks.

Other memory systems are filing cabinets. Mnemo's memory works while you sleep.

"You just talk naturally. Stuff gets saved and processed. It's there when you need it."

— Guy Hutchins, creator

Mnemo Cortex is free, open source, and funded entirely by donations — no investors, no ads, no premium tier. Every dollar comes from someone whose AI finally remembered them. If that's you, the jar keeps development moving. If not, use it, share it, and make something good.

GitHub stars
Visit Rocky's Gallery — free art and Kids adventures supporting Mnemo Cortex →
🔍 Kids seek-&-find worlds  ·  🎁 Free Mnemo swag
"Mnemo-Cortex turns AI from a tool into a system that remembers, learns, and improves."
Claude Code
Fluid memory with deep recall.
60-second install. Two hook scripts.
startup hook · writeback hook · zero config
Install for Claude Code
💻
Claude Desktop
Opus 4.6 with fluid detailed memories.
Drop-in bridge. Always remembers.
recall · search · save
Install MCP Bridge
Hermes Agent
Persistent memory for Nous Research's Hermes.
One-shot installer. 12 tools auto-discovered.
stdio MCP · 555ms cold start · works with FrankenClaw
Install for Hermes
🦞
OpenClaw MCP v2
Give your ClawdBot a brain.
Privacy-first — cross-agent sharing off by default.
share switch · session toggle · per-agent privacy
Install OpenClaw MCP
Install
Fresh checkout to running server in five steps
$ git clone https://github.com/GuyMannDude/mnemo-cortex.git && cd mnemo-cortex
$ python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
$ pip install -e .
$ mnemo-cortex init    # config wizard — pick your models
$ mnemo-cortex start   # server up on port 50001
Linuxnative
Windowsnative — no WSL
macOSbeta — testers wanted

Python 3.11+ · Ollama recommended, or any API provider · On a Mac? Read the macOS install guide and join the beta.

Also works with
🦙 Any Local LLM

Run any local model. Add Mnemo for memory. No cloud, no subscription, no API keys.

LM Studionative MCP
AnythingLLMAutomatic mode
Open WebUInative MCP
llama.cppnative MCP
Ollamavia MCPHost
LobeChatMCP plugin
Janextensions

9 tools out of the box — semantic memory + Developer's Passport. Auto-detects optional brain-lane and wiki dirs and adds up to 8 more tools when present. No flags. No switches. If the dir is on disk, the tool registers.

Zapier charges $20–50/month for AI tool connections. Mnemo on your local LLM: $0/mo, fully private, runs on hardware you already own.

Setup Guides →
New — from the Mnemo family
🧤 Omnemo — memory for Omarchy

One shared memory for every agent harness on the box. Save in one, recall in any.

$ pipx install omnemo
$ omnemo setup   # registers every harness — skill, bar widget, MCP
Claude CodeMCP
CodexMCP
OpenCodeMCP
CrushMCP
Gemini CLIMCP
Piskill

Proven live: a memory saved by Claude Code (Anthropic), recalled by Codex (OpenAI). Glove-fit for Omarchy — built entirely from its own extension points, so it survives every omarchy update.

Shared Memory Spine

Multiple agents. Separate execution environments. One unified memory system.

AI stops resetting. Knowledge compounds. Systems evolve instead of restart.

Without Mnemo
  • "AI session"
  • Forgets everything
  • Starts from zero
With Mnemo
  • AI operator that grows
  • Remembers everything
  • Builds on yesterday

Semantic Recall

Not keyword lookup. Not file search. Meaning-based retrieval.

"What worked on April's ads last week?"

Returns: winning creatives, audience signals, decisions. Not just logs — insight extraction.

Semantic Search
Ask a natural language question. Get the most relevant memories ranked by meaning.
Claw-Recall (FTS5)
When meaning isn't enough — exact-match search for terms, names, filenames, error messages.
The Thesaurus Loop — in development
Every recall commits to one phrasing. If a memory was filed under different words than you searched for, the match is weak or misses — assumption misalignment between how you ask and how it was stored. The Thesaurus Loop fans a query into several alternative phrasings and lets the best match win. The trick is escalation: it only fires when a search comes back empty or weak, so good searches stay exactly as fast as they are today and the expansion pass costs nothing until it's actually worth it.

Cross-Agent Cognition

One agent executes. One builds. One architects.

All of them: read each other. Learn from each other. Evolve together.

A team of AI that shares experience.
Isolated writes · Privacy-controlled reads · One memory spine
  Execution       Builder       Strategy
  Hermes          Claude Code   Claude Desktop
       |               |               |
       v               v               v
  memory/exec/    memory/build/ memory/arch/
       \              |              /
        \             |             /
         -------> MNEMO CORTEX <------
                  SQLite + FTS5
                  port 50001

Dreams Across Agents

Every night at 3 AM, Mnemo reads every agent's memories from the day. An LLM synthesizes them into a single brief: what was built, what was decided, what's blocked, what each agent should know about the others' work.

Every agent wakes up caught up. No manual relay. No "hey, go tell the other one what you just did." It just happens.

Zep and Letta store memory per agent.
Mnemo synthesizes across all of them overnight.
That's a different category.
  3:15 AM — while you sleep

  mnemo-dream.py
    1. Harvest all agent memories since last dream
    2. Send to LLM for cross-agent synthesis
    3. Write dream brief back to Mnemo

  Next morning, each agent boots:

  Execution       Builder       Strategy
  reads dream     reads dream   reads dream
  knows what      knows what    knows what
  everyone did    everyone did  everyone did

Cost: one cheap LLM call per night. The dream brief is searchable like any other memory — agents can recall dreams from weeks ago. Cross-agent awareness that compounds over time.

Cortex Stick — sneakernet for AI memory

You work from two desks. Both machines run Mnemo, and they drift — the decision you saved at one desk doesn't exist at the other. The usual fixes put your AI's working memory on somebody else's wire, or need infrastructure you don't want to run.

The Cortex Stick is a USB courier between two full Mnemo installs. Nothing runs on the stick; it carries the delta. Plug in, sync, pull it out, carry it, plug it in — the other machine catches up. No cloud, no VPN, no account.

It ships inside Mnemo Cortex.
No separate download — if you have Mnemo, you have the courier. Optional AES-256, and the key never lives on the stick.
  $ mnemo-cortex stick init --encrypt /media/you/USB   # or plain, your call
  $ mnemo-cortex stick sync                            # at each desk
  $ mnemo-cortex stick watch --notify                  # or never touch a terminal

  Safe to remove ✓
How the courier works

The Librarian — Document Discovery

“The file about X” is a memory problem too. The Librarian is a single index over your whole workspace — filenames, paths, and the first chunk of every file's content, with text pulled out of PDFs and Word documents — so an agent turns a fuzzy description into a real path in milliseconds.

Our own deployment covers ~107,000 files. A full rebuild takes about 17 seconds; the nightly refresh takes about 2. Secrets are excluded from the index entirely — keys, .env files and credentials never get indexed, so asking the Librarian a question can't surface them.

Indexing everything is cheap.
Compiling everything is not.
The Librarian replaced WikAI, our earlier auto-compiled wiki layer — and that swap is the most useful thing we learned all year.
  $ python3 librarian.py index          # build it
  $ librarian.py find "the spec about X"  # ask it

  Agents ask through the file_find tool in FrankenClaw.
  One stdlib-only Python file. It ships in the repo.

We ran a compiled wiki in production for months, inspired by Andrej Karpathy's LLM Wiki pattern and Nate B Jones's analysis of write-time vs query-time memory. The lesson was blunt: compiling knowledge into pages is expensive to keep fresh, while indexing everything and finding it on demand is cheap and never stale. So we kept the pages — they're still searchable — and stopped recompiling them nightly. Shipping the replacement mattered more than defending the original.

Disco-Bus — Delivery-Confirmed Messaging

Multi-agent message bus with full delivery confirmation. Originally lived inside Mnemo Cortex; now ships as its own product.

See Disco-Bus →

Developer's Passport — Safe Behavioral-Claim Ingestion

A reference-grade safety layer for developers building agent systems. Captures how a user works — tone, density, formality, workflow choices — so agents can adapt to them instead of forcing the user to adapt.

Observations become candidates. Candidates get reviewed. Only stable claims promote into the user's profile. Nothing auto-lands.

The user is always the gate.
5 MCP tools, a review queue, 32 content detectors, 4 provenance buckets, git-tracked audit. Current eval: 53.0% accuracy / 0.458 macro-F1 against a 200-entry labeled corpus. Beta.

Five MCP tools: passport_get_user_context, passport_observe_behavior, passport_list_pending_observations, passport_promote_observation, passport_forget_or_override. Reference integration via stdio MCP. The hosted HTTP wrapper for browser-based AIs (claude.ai custom connectors, etc.) is a future release — today's release is for developers who wire MCP subprocesses into their own agent stacks.

mnemo-plan — Project Pad for Your Agents

Mnemo Cortex captures conversation memory automatically — what agents said, what happened, what was decided. mnemo-plan is the opposite: the stuff you write and curate. Project specs. Active task lists. Decision logs. Architecture docs. Anything an agent needs to know before a conversation starts.

It's a folder of markdown files in Git. Any LLM that can call the Mnemo MCP tools read_brain_file / write_brain_file / list_brain_files can read and edit them. Not Claude-specific.

You write it. They read it.
No new MCP tools. No daemon. No schema. Markdown in Git. Point your bridge's BRAIN_DIR at it and your agents have project context the moment they start a session.

The starter template ships with project.md, active.md, stack.md, decisions.md, plus optional people.md and incidents.md. Each file has comments explaining what goes there. Fork it, fill it in, restart your agent.

The split: Mnemo Cortex = automatic conversation memory. mnemo-plan = manual project pad. Both ride the same MCP bridge; they auto-enable based on whether BRAIN_DIR is set on disk.

Template repo on GitHub →

Three Layers, One Source of Truth

Mnemo Cortex is no longer a memory store. It's a memory architecture.

Mnemo Cortex
Source of truth. Raw facts, sessions, key events. Multi-agent, query-time. The librarian's filing cabinet.
The Librarian
Discovery layer. One index across every file you own. Ask for a file in your own words, get a real path. The card catalogue.
Brain Files
Live working memory. Current state, identity, active context per agent. Ephemeral. The sticky notes on your desk.
When they disagree, Mnemo wins.
The index is always rebuildable from what's on disk. Brain files are ephemeral.

We did not invent this

We adopted the best ideas in the air, credited them openly, and built on top.

Andrej Karpathy
LLM Wiki pattern (April 2026, 41,000+ bookmarks). Inspired WikAI, the compiled wiki layer we ran in production before The Librarian replaced it — and the "idea file as publishing format" pattern in SETUP-PROMPT.md.
Nate B Jones
OpenBrain + "Your AI Does the Hard Work Then Deletes It". Inspired our three-layer architecture: structured store + a discovery layer over everything + ephemeral brain files. Substack.
Google A2A Protocol
A2A spec. Disco-Bus speaks A2A's data shapes today; transport is the v2 roadmap.

Standalone by Design

Mnemo Cortex is not a wrapper, a bridge, or a plugin for someone else's memory cloud. It's the whole system — storage, recall, and overnight maintenance, running on hardware you own.

sqlite-vec Recall
Semantic search over local vector embeddings. Meaning-based retrieval with no API call and no per-query cost.
Facts Table
Hard truths stored as structured facts, separate from conversational memory — so the important stuff doesn't drown in the chatter.
Dreamer Compaction
Overnight, the Dreamer distills the day's raw memories into briefs every agent reads at boot. Memory that maintains itself.
Per-Agent Lanes
Each agent writes to its own lane. Isolated writes, no cross-contamination, clean provenance on every memory.
Cross-Agent Recall
Agents read each other's lanes when you allow it. Agent A can know what Agent B learned — privacy-controlled.
Cross-Platform
The server runs natively on Linux, macOS, and Windows — no WSL. As of v4.4.1, cross-platform file locking lets it start and serve recall on native Windows Python.
Auto-Capture
Session activity flows into memory automatically. Manual saves are for the decisions; ambient capture handles the rest.
135+ stars on GitHub and counting.
Open source · SQLite under the hood · Your data never leaves your machine

Deploy Your Way

Most memory products make you choose: one shared store for everything. Mnemo lets you architect for your actual privacy and separation needs.

🌐
Shared
One Mnemo instance for all agents. Cross-agent search and dreaming. Full team awareness. Best for internal teams where every agent should see everything.
🔒
Isolated
Separate Mnemo per agent or per customer. Zero bleed between tenants. Perfect for customer-facing bots where visitor A must never see visitor B's history.
🔧
Hybrid
Shared Mnemo for internal agents + isolated instances for customer-facing bots. Cross-agent dreaming for the team, strict privacy for customers. This is what we run.
Privacy isn't a setting. It's a topology decision. Mnemo gives you the architecture to make it.

Memory with Lineage

Most systems: summarize = discard detail.

Mnemo-Cortex: compress memory, keep traceability.

Go from high-level summary down to the exact moment. ~80% compression. Full fidelity preserved.

Auditable AI thinking.
DAG-based lineage · Every summary traces to source

No API burn. No per-query cost. No cloud dependency.

SQLite. Local compute. Any LLM for compaction — Ollama for $0, or any API provider you choose.

Scaling
Memory grows without costs growing.
Autonomy
Your data stays on your hardware.
Margins
The cost of remembering is $0.

AI that gets better every week

Over time, Mnemo-Cortex builds: what worked, what failed, what changed. Without re-training.

This is what current AI tools are missing.

Execution Agent
Gets better at testing, customer service, creative work.
Builder Agent
Gets better at wiring, debugging, deploying.
Strategy Agent
Gets better at architecture, planning, positioning.

They don't blend. They specialize. That's closer to a real company team than a chatbot.

Upgraded by Claude Fable 5

During Claude Fable 5's brief availability, we pointed it at the memory layer it runs on and asked it to make it better. The result shipped as Mnemo's v4.1 "Fable pass."

Composite recall ranking
The fix that pulled real signal back to the top of every search — blending similarity, recency, category, and access instead of raw vector score alone.
The Analyst
Distills raw session logs into clean, high-signal Tier-1 notes — so recall surfaces decisions, not transcript noise.
Secret redaction at ingest
Every byte entering the store passes a redaction choke point first — API keys never reach a remote classifier.
Tier hygiene
Deleted memories stay deleted; the two-tier recall path stops stale rows resurrecting from cache.
A frontier model auditing the memory it thinks with.
Fable 5 reasoned and reviewed the whole codebase; an Opus model reviewed, hardened, and shipped each change — in a single window before Fable went dark.

Business Intelligence Engine

Mnemo-Cortex stores: ad performance, creative wins, audience behavior, product trends.

Over time, it becomes: a brain for the business. Not a tool.

Week Over Week
What worked. What failed. What the customer wants. No re-onboarding. No lost context.
Month Over Month
Patterns emerge. Strategy compounds. Your AI advisor remembers the whole story.

What makes this different

Everyone Else
  • "AI memory"
  • "Chat history"
  • "RAG system"
Mnemo-Cortex
  • Persistent
  • Multi-agent
  • Semantic, evolving cognition

That's a different category.

You didn't just build something useful. You built infrastructure. And infrastructure is where the leverage is, the lock-in is, the money is.

Live stats — last 14 days

322
GitHub Clones
159
Unique Cloners
3
Integration Paths
3
Active Agents
~80%
Compression
6+ wks
Continuous Recall

What you get

AI that doesn't forget.
AI that learns over time.
AI that works as a team.
AI that gets better every week.
Get it on GitHub

Mnemo Cortex vs OpenClaw Active Memory

They're Not the Same Thing.

OpenClaw 2026.4.10 shipped a native Active Memory plugin. Some people have asked whether it replaces Mnemo Cortex. Short answer: no — they solve different problems.

Here's the difference, based on testing both on our sandbox agent.

Active Memory (native) Mnemo Cortex (MCP)
Scope Single agent Cross-agent (multi-agent bus)
Store Local workspace files + FTS Centralized SQLite + embeddings
Persistence Per-agent, per-workspace Survives resets, sessions, machine moves
Cross-session Within one agent's workspace Any agent, any machine
Integration Independent store Independent store
OpenClaw's Active Memory
Intra-session, same-agent, fast local recall. Your agent's personal scratchpad. Great for recent context within a single workspace.
Mnemo Cortex
Cross-agent memory bus. When Agent A needs to know what Agent B learned. When memory must survive session resets, machine moves, or agent restarts.
We run both. OpenClaw's Active Memory handles per-agent recent context. Mnemo handles everything that crosses agents or needs durable archival. They stack; they don't compete.

Project Sparks

Built in Half Moon Bay, California by Guy Hutchins and a team of AI agents running on the memory system you're looking at.

The Project Sparks story →

Smart memory saves real money

AI agents without memory repeat expensive work. Every session starts from zero — re-reading files, re-analyzing context, re-discovering what worked yesterday. That's your API bill paying for the same thinking twice.

Mnemo Cortex remembers what worked, what failed, and what changed. Your agents stop recomputing and start building on yesterday's knowledge. Fewer tokens burned. Fewer expensive model calls wasted on context recovery.

Mnemo Cortex makes every call count — it gives your smart models full context on the first try, so there are no expensive retry loops and no tokens wasted rediscovering what the agent already knew. Your agents stop paying to re-learn yesterday.

Support the project

No investors. No ads. No premium tier. Just one maker, his agents, and a tip jar — every dollar keeps AI memory free and open source.