memoir-cli
Advanced tools
MCP server that gives Claude, Cursor, and Gemini long-term memory across sessions. Your AI remembers your codebase, decisions, and preferences — across tools and machines.
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 8 more tools.
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.
npx memoir-cli
That's it. memoir detects your AI tools, configures MCP, and activates memory. No global install needed.
Your AI gets 7 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 |
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.
13 tools supported: Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, OpenAI Codex, ChatGPT, Aider, Zed, Cline, Continue.dev, Augment, Trae.
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.
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
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.
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
| 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 |
MIT Licensed
FAQs
Private, portable AI memory: synced across every coding tool and machine, end-to-end encrypted, free. One memory for Claude Code, Cursor, Copilot, Gemini + more — MCP-native, zero-knowledge, open source.
The npm package memoir-cli receives a total of 215 weekly downloads. As such, memoir-cli popularity was classified as not popular.
We found that memoir-cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Open source maintainers are under more pressure than ever. We're raising our open source program from the Team plan to the Business plan, free.
Security News
The supply chain control that delays freshly published gems now covers lockfile generation and gem vendoring in Ruby projects.
Security News
During a UK cyber test, a Mythos 5 agent used sockpuppets, social engineering, and prompt injection to try to get a maintainer to merge malware.