🧠 VibeMem

The Persistent Memory Layer for Vibe Coding

Never explain your project twice to Claude, Cursor, Gemini CLI, or any AI coding tool again.

100% Local • Git-Friendly • Zero-Config • MCP-Powered

🤔 Why VibeMem?

AI coding tools suffer from amnesia.
Every time a new session starts, you find yourself painfully re-pasting your architecture, tech stack decisions, edge cases, and favorite conventions.

VibeMem fixes this forever:

• 📂 Local Repository Storage: Keeps your project's memory securely inside the .vibemem/ directory.
• 🧠 Auto-Capture: Automatically snags decisions & project summaries directly from Claude or Cursor.
• 💸 Token Saver: Injects precisely what the AI needs for context—saving you 70–90% on token usage.
• 🛠️ Universal Compatibility: Seamlessly powers Claude Code (MCP), Cursor rules, and Gemini CLI.
• ✏️ Human-Readable: Fully editable via standard Markdown files or your favorite SQLite DB browser.
• 🌿 Git-Native: Your AI's memory travels with your branches and easily survives merges.

⚡ Quick Start (30 seconds)

# 1. Navigate to your existing project
cd my-vibe-project

# 2. No global installs—just initialize directly!
npx vibemem@latest init

# 3. Drop a memory manually (or let auto-capture handle it)
npx vibemem save "Use Anchor v0.30 for the BagsApp royalty swap program"

# 4. Next session? Inject memory straight to your clipboard
npx vibemem inject

# 5. BONUS: Run the native MCP server for Claude Code
npx vibemem mcp

(In Claude, simply run: claude mcp add vibemem npx vibemem mcp)

✨ Boom! Your AI now has permanent context.

✨ Standout Features

• 🔋 Zero-Config Setup: Run npx vibemem init and you're immediately good to go.
• 🚀 Blazing Fast SQLite + FTS5: lightning-quick semantic searches with a tiny footprint (<5 MB after months of heavy use).
• 🔌 Native MCP Server: Instantly compatible with the new Claude Code stdio standard.
• 📝 Auto summary.md: Generates a clean, human-readable project overview that's perfect for version control.
• 🔎 Hyper-Fast Search: Locate obscure, months-old project decisions in under 50ms.
• 🤝 Git Workflow Integration: Commit your .vibemem/summary.md and easily ignore the .vibemem/memory.db.

💻 Installation

The Fast Way (Recommended)

Use npx to run it effortlessly without clotting up your global packages:

npx vibemem@latest init

The Standard Way (For Devs & Forks)

npm install vibemem
# or using pnpm/yarn:
pnpm add vibemem

Then initialize it locally:

npx vibemem init

⌨️ CLI Commands Reference

| Command | Action | | :--- | :--- | | vibemem init | 🏗️ Scaffolds .vibemem/ and generates initial config | | vibemem save <text> | 💾 Manually stores a specific memory or decision | | vibemem load [limit] | 📋 Fetches top memories and copies them to clipboard | | vibemem inject | 💉 Generates a ready-to-paste <vibemem> context snippet | | vibemem search <query> | 🔍 Performs a deep keyword search through past memories | | vibemem summary | 🔄 Forces an immediate update of your summary.md | | vibemem mcp | 📡 Spins up the MCP stdio server for Claude Code | | vibemem stats | 📊 Displays DB size, memory count, and usage metrics |

🤖 MCP Tools (Tailored for Claude Code)

Once you have npx vibemem mcp running, these tools become a native part of your AI's brain:

• 🟢 vibemem_save
• 🟢 vibemem_search
• 🟢 vibemem_load
• 🟢 vibemem_inject
• 🟢 vibemem_summary
• 🟢 vibemem_stats

🗺️ Roadmap

• [ ] Auto-Capture Magic: Extract context directly from Claude/Cursor session transcripts.
• [ ] Local Vector Embeddings: Deep semantic search via sqlite-vec or transformers.js.
• [ ] First-Class Integrations: Official Cursor .rules syncing & Gemini CLI wrapper.
• [ ] Editor Extensions: Dedicated VS Code and Zed plugins for a seamless GUI experience.
• [ ] Team Alerts: Webhook push notifications (Telegram/Discord) whenever the core summary updates.

🤝 Contributing

We love pull requests! If you want to make VibeMem even better:

1. Fork the repo
2. Create your feature branch
3. Submit a PR targeting main

📄 License

MIT © 2026 vibemem