memoir is a CLI tool that gives AI coding assistants persistent memory via MCP (Model Context Protocol). It works with Claude Code, Cursor, Windsurf, Gemini, and 10 more tools.

How does memoir work?

memoir runs as an MCP server. Your AI tools read and write memories automatically during conversations. Tell Claude your API conventions once — next week, in Cursor, it already knows.

Yes. memoir is free and open source (MIT licensed). The free tier includes all 7 MCP tools, 11 AI tool support, local backup, and E2E encryption. Pro ($15/mo) adds unlimited cloud sync.

Persistent memory for AI coding tools

Your AI forgets everything. Give it long-term memory.

memoir runs via MCP inside Claude, Cursor, and 9 more tools. Your AI remembers your codebase, preferences, and decisions across every session.

$ npx memoir-cli

13 AI tools MCP native E2E encrypted MIT licensed ★ GitHub

The problem

Every AI session starts from zero

You've explained your architecture, your conventions, your preferences. Next session, it's all gone.

"We use Zustand, not Redux"

You told Claude last week. Today it's suggesting Redux again.

memoir_recall finds it instantly

"My context is stuck in Cursor"

Weeks of training one tool. Switch to another — all gone.

memoir migrate --from cursor --to claude

"New laptop, blank slate"

Every AI tool wiped. Every project missing.

memoir restore -y — 60 seconds

How it works

memoir sits between you and your AI tools

Via MCP (Model Context Protocol), memoir gives every AI tool access to a shared memory layer. Your AI reads and writes memories automatically as part of the conversation.

Tell Claude your API conventions once. Next week, in Cursor, it already knows.

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_status See which AI tools are detected
memoir_profiles Switch between work and personal

13 tools supported

Claude Code

Cursor

Windsurf

Gemini

ChatGPT

Codex

Copilot

Zed

Cline

Continue

Aider

Claude Code

→

memoir MCP

Cursor

→

memoir MCP

Windsurf

→

memoir MCP

Your memories, decisions, preferences encrypted · synced across machines

In action

Your AI recalls what you told it last week

memoir runs in the background. Your AI reads and writes memories as part of the conversation.

Claude Code

# You ask Claude about your auth setup...

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. You chose Zustand over Redux

for the auth state (decided March 12).

No re-explaining needed. memoir remembered.

Get started

Running in under two minutes

Step 01 — Install

One command. Zero config.

Auto-detects your GitHub, creates a private repo, backs up everything.

npx memoir-cli

Step 02 — Connect

Add MCP to your tools

Add memoir as an MCP server to any tool that supports it.

// ~/.mcp.json { "mcpServers": { "memoir": { "command": "memoir-mcp" } } }

Step 03 — Done

Your AI remembers

Start a conversation. memoir works in the background.

"How does auth work here?" memoir_recall("auth") Found 3 memories.

Beyond MCP

Full AI context sync

memoir also handles the things MCP can't — workspace sync, session handoff, cross-machine backup.

Workspace sync

Git repos auto-clone, non-git projects bundle, uncommitted changes save as patches and reapply on restore.

memoir push — 44 projects saved

Session handoff

Captures what you were working on. Files changed, errors hit, decisions made. Your AI picks up mid-conversation.

memoir push && memoir restore

AI migration

Translate your instructions between tools using AI. Not just file copy — rewrites conventions properly.

memoir migrate --from claude --to cursor

Memory consolidation

Over time, memories pile up. Consolidate finds duplicates, flags stale context, and uses AI to merge and prune intelligently.

memoir consolidate --smart

E2E encryption

AES-256-GCM before anything leaves your machine. Secret scanning auto-redacts API keys and tokens.

memoir encrypt && memoir doctor

Comparison

How memoir compares

	memoir	Dotfiles	ai-rulez	memories.sh
MCP memory layer	6 tools	No	No	No
AI memory sync	13 tools	No	18 tools	3 tools
Cross-tool recall	Yes	No	No	No
Workspace sync	Yes	No	No	No
Session handoff	Yes	No	No	No
AI migration	Yes	No	No	No
E2E encryption	Yes	No	No	No
Cloud backup	Yes	No	No	$15/mo
Free & open source	Yes	Yes	Yes	No

Pricing

Start free. Scale when you need to.

Free

$0 / forever

For solo devs getting started

MCP server with all 7 tools
All 11 AI tools supported
Local backup & restore
3 cloud backups
AI-powered migration
Memory consolidation
E2E encryption

Install free

Pro

$15 / month

For power users on multiple machines

Everything in Free
50 cloud backups
Unlimited machines
AI-powered consolidation
Version history
Priority support

Upgrade to Pro

Teams

$29 / seat / mo

Shared memory for dev teams

Everything in Pro
Shared team memory
Onboard AI to your codebase
Team dashboard
Audit log

Join waitlist

Your AI forgets everything. Give it long-term memory.

"We use Zustand, not Redux"

"My context is stuck in Cursor"

"New laptop, blank slate"

One command. Zero config.

Add MCP to your tools

Your AI remembers

Workspace sync

Session handoff

AI migration

Memory consolidation

E2E encryption

Your AI should remember you