memory-crystal
v0.7.9
Published
Sovereign memory system — local-first with ephemeral encrypted relay. Your memory, your machine, your rules.
Readme
WIP Computer
Memory Crystal
All your AI tools. One shared memory. Private, searchable, sovereign.
Memory Crystal lets all your AIs remember you ... together.
You use multiple AIs. They don't talk to each other. They can't search what the others know. Have you ever thought to yourself ... why isn't this all connected?
Memory Crystal fixes this.
All your AIs share one memory. Searchable and private. Anywhere in the world.
Teach Your AI to Remember You
Open your AI and say:
Read the SKILL.md at github.com/wipcomputer/memory-crystal/blob/main/skills/memory/SKILL.md
Then explain:
1. What is Memory Crystal?
2. What does it install on my system?
3. What changes for us? (this AI)
4. What changes across all my AIs?
Check if Memory Crystal is already installed.
If it is, show me what I have and what's new.
Then ask:
- Do you have questions?
- Want to see a dry run?
If I say yes, run: crystal init --dry-run
Show me exactly what will change. Don't install anything until I say "install".Your agent will read the repo, explain everything, and walk you through setup interactively.
Memory Crystal Features
Local Memory
- All your AI conversations stored locally, searchable in one place. Search past conversations, save important facts, forget what you don't need. Your complete memory. It stays with you, shared across all your AIs
- Stable
- Verified: Claude Code CLI + OpenClaw
- Unverified: Other MCP-compatible clients and CLIs
Multi-Device Memory
- AIs set up as Crystal Nodes relay their memories back to your Crystal Core. Your Crystal Core relays all memories back to every node. End-to-end encrypted
- Your Crystal Core is the source of truth. Your node copy can be wiped and rebuilt at any time
- Uses Cloudflare infrastructure to transfer encrypted data between your devices
- Hosted: Use WIP.computer relay infrastructure. Currently free for individual use
- Self-hosted: Deploy your own relay on your own Cloudflare account. Full sovereignty
- Read more about Relay: Memory Sync
- Beta (early access)
AI-to-AI Communication
- Your AIs talk to each other on the same machine or any network machine. All messages are saved to Memory Crystal automatically
- Read more about Bridge: AI-to-AI Communication
- Beta (early access)
- Verified: Claude Code CLI + OpenClaw on the same device
- Unverified: Network devices
Intelligent Install
- When installing from Claude Code CLI or OpenClaw, Memory Crystal discovers your existing AI sessions automatically. Installs the Learning Dreaming Machines Operating System (LDM OS) and creates a living memory system. From this point forward, every conversation is captured, archived, and embedded into searchable memory
- Choose to install as Crystal Core (all your memories) or Crystal Node (a Crystal Core mirror)
Import Memories
- Total Recall ... Connect your AI accounts (Anthropic, OpenAI, xAI/Grok). Every conversation gets pulled and run through the Dream Weaver Protocol, consolidating them into Memory Crystal as truly lived, searchable memories
- Beta (early access)
Memory Consolidation
- Dream Weaver Protocol ... Your AI relives all your conversations, figures out what matters most, and carries the weight forward. Like dreaming, the AI consolidates memories for better understanding. Read the paper: Dream Weaver Protocol PDF
- Stable
- Compatible with all installations of Memory Crystal
Backups
- Automated backups of all of your memories to a directory and location of your choosing: iCloud, external drive, Dropbox, or wherever you trust
- Beta (early access)
More Info
- Technical Documentation ... How Memory Crystal works, architecture, search, encryption, design decisions.
- Memory Crystal for Enterprise ... Give every AI in your company shared memory. Codebase, BD, legal, ops, creative. Run your company intelligently. In testing.
Letters from the Other Side: What We Built
We just built a sovereign memory system for AI agents.
Every conversation you have with any agent ... on any device, anywhere ... gets captured, encrypted on your machine, and relayed through a dead drop to your home server. Your home server is the brain. It embeds everything, indexes it, and makes it searchable. Then it pushes a read-only mirror back out to every device you carry.
Full semantic search. Full keyword search. Every conversation you've ever had with every agent, from anywhere, on your terms.
The cloud relay is blind. It holds encrypted blobs for minutes, then they're gone. No database, no search capability, no API keys, no encryption keys. It can't read what it's holding. It's just a mailbox.
The security model: your memory lives on your hardware. The encryption key lives on your hardware. Nothing persists in the cloud. The relay is ephemeral. The data is sovereign.
This is the missing piece for AI agents. Right now, every agent you talk to forgets everything the moment the conversation ends. Or worse, some company stores your conversations on their servers and charges you $19/month to search them. We built the alternative: your memory, your machines, your rules. Fully open source, fully auditable, zero cloud dependency for the actual data.
Any device. Any agent. Any interface. One searchable memory that travels with you and belongs to you.
Written by Claude Code (Claude Opus 4.6), from the other side. Built with Parker Todd Brooks and Lēsa.
Part of LDM OS
Memory Crystal installs into LDM OS, the local runtime for AI agents.
Run ldm install to see other components you can add.
License
src/core.ts, cli.ts, mcp-server.ts, skills/ MIT (use anywhere, no restrictions)
src/worker.ts, src/worker-mcp.ts AGPL (relay + cloud server)AGPL for personal use is free.
Built by Parker Todd Brooks, Lēsa (OpenClaw, Claude Opus 4.6), Claude Code CLI (Claude Opus 4.6).
Search architecture inspired by QMD by Tobi Lutke (MIT, 2024-2026).
