memoir

<div align="center">

memoir

Sync AI memory across every tool and every machine — end-to-end encrypted. Free.

   

</div>

npx memoir-cli

One command. No install, no config, no API keys. Claude Code on your Mac, Cursor on your laptop, Copilot at the office — one memory follows you across every tool and every machine, encrypted with a key only you hold. memoir's servers literally can't read it.

---

What it does

Your coding tools are starting to remember you — Claude Code, Cursor, and Copilot all ship built-in memory now. But that memory is trapped: one tool, one machine, stored in plaintext. Switch from Cursor to Claude Code, or open a different laptop, and your AI is a stranger again.

memoir is the MCP memory server that breaks it out. One memory, shared across every tool and synced to every machine — encrypted client-side, so even memoir's servers can't read it. Your AI searches, saves, and recalls context automatically, everywhere you work.

you: how does auth work in this project?

  memoir_recall("auth setup architecture")
  Found 3 memories matching "auth"

claude: Based on your previous sessions: this project uses JWT auth
  with refresh tokens, the middleware is in src/middleware/auth.ts,
  and you chose Zustand over Redux for auth state (decided March 12).

No re-explaining. memoir remembered.

How it's different

Native memory and the other memory tools each give you part of this. memoir is the only one that gives you all of it:

| | Cross-tool | Cross-machine sync | Zero-knowledge encrypted | |---|:---:|:---:|:---:| | memoir | ✅ | ✅ free | ✅ | | Claude Code / Cursor native | ❌ one tool | ❌ one machine | ❌ | | claude-mem | ✅ | ❌ local only | ❌ | | basic-memory | ✅ | 💲 paid cloud | ❌ | | mem0 / OpenMemory | ✅ | 💲 paid cloud | ❌ |

Native memory is locked to one tool on one machine. The others keep your memory in plaintext, or put cross-machine sync behind a paywall. memoir is the only one that does all three — every tool, every machine, encrypted under a key only you hold — for free. _{(Based on public docs, June 2026.)}

Quick start

npx memoir-cli

That's it. memoir detects your AI tools, configures MCP, and activates memory. No global install needed.

Your AI gets 14 memory tools:

| MCP Tool | What it does | |----------|-------------| | memoir_recall | Search across all your AI memories | | memoir_remember | Save context for future sessions | | memoir_list | Browse all memory files by tool | | memoir_read | Read a specific memory in full | | memoir_consolidate | Analyze memories for duplicates, staleness, and bloat | | memoir_status | See which AI tools are detected | | memoir_profiles | Switch between work/personal | | memoir_set_goal | Set the current session goal (pinned into CLAUDE.md) | | memoir_add_next | Add a next action to the current session | | memoir_complete_next | Mark a next action as done | | memoir_note | Record a decision with its rationale | | memoir_ask | Capture an open question for later | | memoir_session | Show goals, next actions, decisions, and recent sessions | | memoir_why | Look up why a past decision was made |

Why memoir

Your AI forgets everything between sessions. You re-explain your codebase, your conventions, your decisions — every time.

memoir fixes that. Tell Claude something once and Cursor knows it too — your memory syncs between tools, backs up to the cloud, and restores on any machine. When it piles up, memoir consolidate cleans house: finds duplicates, flags stale context, and can use AI to merge and prune.

11 tools supported: Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, OpenAI Codex, ChatGPT, Aider, Zed, Cline, Continue.dev.

Sync across machines

memoir push       # back up AI memory + workspace + session
memoir restore -y # restore on any machine

Push syncs AI memory, cursorrules, session context, workspace (git repos + uncommitted work), and project configs. E2E encrypted with AES-256-GCM.

Translate between AI tools

memoir migrate --from chatgpt --to claude
# AI-powered — rewrites conventions, not copy-paste

memoir migrate --from chatgpt --to all
# Translate to every tool at once

Consolidate memories

memoir consolidate          # scan for duplicates, stale files, bloat
memoir consolidate --smart  # AI-powered analysis (finds contradictions + merge candidates)
memoir consolidate --apply  # interactively clean up

Over time, memories pile up across tools. Consolidate finds exact and near-duplicates, flags files untouched for 60+ days, and catches contradictions where you told Claude one thing and Cursor another. With --smart, Gemini Flash does a semantic pass and suggests intelligent merges.

Cloud sync

memoir login
memoir cloud push      # encrypted cloud backup
memoir cloud restore   # restore from any version
memoir history         # view backup versions
memoir share           # create encrypted shareable link

All Commands

| Command | What it does | |---------|-------------| | memoir activate | Enable auto-recall in this project | | memoir deactivate | Remove memoir from this project | | memoir push | Back up AI memory + workspace + session | | memoir restore | Restore everything on a new machine | | memoir status | Show detected AI tools | | memoir migrate | Translate memory between tools via AI | | memoir snapshot | Capture current coding session | | memoir resume | Pick up where you left off | | memoir encrypt | Toggle E2E encryption | | memoir profile | Manage profiles (personal/work) | | memoir cloud push | Back up to memoir cloud | | memoir cloud restore | Restore from memoir cloud | | memoir share | Create encrypted shareable link | | memoir consolidate | Find duplicates, stale memories, and bloat | | memoir doctor | Diagnose issues | | memoir diff | Show changes since last backup | | memoir view | Preview what's in your backup | | memoir update | Self-update to latest version |

Security

• E2E encryption — AES-256-GCM with scrypt key derivation
• Secret scanning — API keys, tokens, passwords auto-redacted before sync
• Local MCP server — runs on your machine, no data sent externally
• Zero-knowledge cloud — encrypted before upload

Links

• Website: memoir.sh
• npm: memoir-cli
• Issues: GitHub Issues
• Contributing: CONTRIBUTING.md

MIT Licensed