memoir

Sync AI memory across every coding tool. Zero config.

npx memoir-cli

One command. No install, no config, no API keys. Your AI now has persistent memory across sessions, tools, and machines. Works with Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, and 6 more tools.

What it does

memoir is an MCP memory server that gives your AI tools persistent memory. Your AI can search, save, and recall context automatically — like a Claude Code backup that works everywhere.

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.

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:

Why memoir

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

memoir fixes this by giving your AI a shared memory layer that works across every tool you use. Tell Claude something once. Cursor knows it too. Sync AI memory between tools, back it up to the cloud, restore it on any machine. And when your memories pile up, memoir consolidate cleans house — finds duplicates, flags stale context, and optionally uses 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

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