Note: Formerly known as "Claude Code Buddy (CCB)". Renamed to MeMesh to avoid potential trademark issues.
Make Claude Code remember everything. Build faster. Vibe harder.
🚀 Quick Start • 📖 Docs • 🌐 GitHub • 💬 Discussions
# Session 1 (Monday)
You: "We use JWT for auth because..."
Claude: "Got it! ✅"
# Session 2 (Tuesday)
You: "Remember our auth approach?"
Claude: "Sorry, I don't have context..."
You: *explains everything again* 😤
# Session 3 (Wednesday)
You: "Our JWT implementation..."
Claude: "What JWT implementation?"
You: *RAGE QUITS* 💢 |
# Session 1 (Monday)
You: buddy-do "setup JWT auth"
MeMesh: ✅ Implemented + Saved to memory
# Session 2 (Tuesday)
You: buddy-remember "auth"
MeMesh: 📚 "JWT auth implemented on 2024-01-15
↳ Access tokens: 15min
↳ Refresh tokens: 7 days
↳ Secret rotation: monthly"
# Session 3 (Any day, forever)
You: buddy-do "add OAuth"
MeMesh: 🧠 "I see you have JWT. Let's
integrate OAuth alongside it..." |
memesh-demo.mp4
💡 Try it yourself:
# In Claude Code
buddy-help # See all commands
buddy-do "explain how MeMesh works" # Watch it intelligently respond
buddy-remember "project decisions" # Query your project memory📖 Read User Guide • 🔧 API Reference
You know this pain:
Session 1: "Let me explain our architecture..."
Session 2: "As I mentioned before, our architecture..."
Session 3: "Like I said earlier, our architecture..."
Session 4: 😤
Every. Single. Session.
|
|
# Session 1 (Last week)
You: "We chose PostgreSQL for JSONB support"
# Session 42 (Today)
You: buddy-remember "why PostgreSQL?"
MeMesh: "Based on your decision from 2024-01-15: PostgreSQL was
chosen for JSONB support and advanced query capabilities..."Claude remembers. Forever.
You: "Review this code"
MeMesh: *Detects task type*
*Activates code review mode*
*Applies best practices*
*Delivers structured review*No more "how should I do this?" Just do it.
buddy-do "setup authentication" # Execute any dev task
buddy-remember "API design" # Query project memory
buddy-help # When stuckThree commands. Infinite possibilities.
buddy-secret-store "openai_key" "sk-..." api_key # Store encrypted
buddy-secret-get "openai_key" # Retrieve for API calls
buddy-secret-list # See what's stored
buddy-secret-delete "old_key" # CleanupAES-256-GCM encryption. Local only. Never transmitted.
Choose your preferred installation method:
npm install -g @pcircle/memesh
# Auto-configures everything! Just restart Claude Code.git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.sh/plugin install memesh@claude-plugins-official⚡ Claude Code Users (Click to expand) ⭐ RECOMMENDED
Three simple commands:
git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.shThe script will:
- ✅ Check prerequisites (Node.js 20+)
- ✅ Install dependencies
- ✅ Build MeMesh
- ✅ Auto-configure
~/.claude/mcp_settings.json
Then restart Claude Code completely (quit and reopen).
Done! MeMesh is now available and ready to use.
The `--plugin-dir` flag loads your local plugin. For team distribution, see [Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) to create a shared marketplace.Note: The installer automatically configures your MCP settings. No manual configuration needed!
# In Claude Code, type:
buddy-help
# You should see MeMesh's command list
# Now try:
buddy-do "explain MeMesh features"
# Watch the magic happen ✨🎉 That's it! You're vibing now.
📖 Need help? Detailed installation guide | Troubleshooting
You: buddy-do "create a real-time chat with WebSocket"
MeMesh analyzes your project...
🔍 Detected: React + Node.js + Express
🧠 Recalled: Your preference for TypeScript strict mode
📝 Applying: Error boundaries pattern from LoginPage.tsx
✅ Generated:
├─ server/chat.ts (WebSocket server)
├─ components/ChatWindow.tsx (React component)
└─ hooks/useWebSocket.ts (Custom hook)
💾 Saved to memory: "WebSocket chat architecture - 2024-01-20"You: buddy-remember "authentication approach"
MeMesh searches knowledge graph...
📚 Found 3 related memories:
┌─ 2024-01-15: Initial Auth Decision
│ 💬 "JWT chosen over sessions for stateless API"
│ ⚡ Reasoning: Mobile app compatibility
│
├─ 2024-01-18: Token Expiry Implementation
│ 💻 Code: auth/middleware.ts:42-67
│ 🔧 Access: 15min | Refresh: 7 days
│
└─ 2024-01-22: Security Enhancement
🛡️ Added: Rate limiting + Token rotation
📝 Prevented: Token reuse vulnerabilityDay 1 │ You: "Implement user login"
│ MeMesh: ✅ Created + 💾 Remembered
│
Day 5 │ You: "Add password reset"
│ MeMesh: 🧠 "I see you use JWT tokens..."
│ ✅ Integrated seamlessly
│
Day 10│ You: "Add OAuth support"
│ MeMesh: 🧠 "Based on your JWT + password reset..."
│ ✅ Consistent with existing auth
│
Week 8│ You: "Why did we choose JWT again?"
│ MeMesh: 📚 *Instant recall from Day 1*
No context re-explanation. Ever again.
| Feature | Plain Claude Code | Other MCP Tools | MeMesh |
|---|---|---|---|
| Persistent Memory | ❌ | ✅ Full Knowledge Graph | |
| Smart Routing | ❌ | ❌ | ✅ Auto-detects task type |
| Vibe Coding Optimized | ❌ | ✅ Built for it | |
| Zero Setup | ✅ | ✅ 2 minutes | |
| Free & Open Source | ✅ | ✅ AGPL-3.0 |
Auto-Memory Hooks
What is it? MeMesh remembers what you did in your last coding session and shows you a summary when you start a new one.
- When you open Claude Code → MeMesh shows what you did last time
- While you work → MeMesh quietly tracks your progress
- When you close Claude Code → MeMesh saves a summary for next time
When you start a new session, you'll see something like:
🧠 MeMesh Memory Recall
🕐 Last session: 2 hours ago (45 minutes)
📋 What you did:
📁 Changed 5 files in src/auth/
✅ Made 3 git commits
💡 Implemented JWT refresh tokens
That's it! No setup needed. MeMesh handles everything automatically.
| Icon | What | Example |
|---|---|---|
| 📁 | Files you changed | src/auth/login.ts |
| ✅ | Commits you made | feat: add login |
| 💡 | Things you learned | Use async/await here |
| Problems you hit | API timeout issue |
- Saves automatically every 250K tokens (about 1-2 hours of work)
- Session memories kept for 30 days, then auto-cleaned
- Project memories (code changes, test results) kept for 90 days
- Currently available in Claude Code only
Multi-Project Support
Each project gets its own isolated memory space.
cd ~/project-A
buddy-remember "auth" # Returns project-A's auth decisions
cd ~/project-B
buddy-remember "auth" # Returns project-B's auth decisionsNo cross-contamination. Ever.
Smart Memory Query
Context-aware memory retrieval with intelligent ranking:
- 🎯 Semantic search across your knowledge base
- 🏷️ Auto-tagging for better organization
- 📊 Relevance scoring based on context
Multi-Session Support (Daemon Mode)
Run multiple Claude Code sessions sharing the same memory:
- 🔄 First instance becomes the daemon
- 🔗 Subsequent instances connect as proxies
- 📡 Shared knowledge graph across all sessions
SecretManager
Securely store API keys and credentials:
- 🔐 AES-256-GCM encryption
- 💾 Local SQLite storage (never transmitted)
- 🔑 Use
buddy-secret-storeandbuddy-secret-get
18+ MCP Standard Tools
Full integration with Model Context Protocol for seamless Claude Code experience.
Use buddy-help to see all available commands.
|
|
- ✅ 100% Local Processing - Your data never leaves your machine
- ✅ No External API Calls - Uses your Claude Code subscription
- ✅ npm audit: 0 vulnerabilities
- ✅ Open Source - Audit the code yourself
We'd love your help making MeMesh better!
- 🐛 Found a bug? Open an issue
- 💡 Have an idea? Start a discussion
- 🛠️ Want to code? Check Good First Issues
Contributing Guide: CONTRIBUTING.md
Q: Does it cost money?
A: Nope. 100% free and open source (AGPL-3.0). Uses your existing Claude Code subscription.
Q: Is my data safe?
A: Yes. Everything processed locally. Zero external API calls. Zero data upload.
Q: How is this different from plain Claude Code?
A: MeMesh adds two superpowers:
- Persistent Memory - Claude remembers your project across sessions
- Smart Routing - Automatically detects and handles different task types
Think of it as Claude Code + a really good memory + autopilot mode.
Q: Can I customize it?
A: Absolutely! MeMesh plugin is fully open source.
Want deeper customization? Check our Contributing Guide or fork the repo and make it yours.
Q: Does it work with Cursor?
A: Yes! Cursor has native MCP support. One-click install.
Built on the shoulders of giants:
- Model Context Protocol (MCP) - The foundation
- Claude Code - The platform
- All our amazing contributors and early testers
AGPL-3.0 - See LICENSE
This means: Use it, modify it, share it. But keep it open source.
Stop repeating yourself. Start vibing.
🚀 Get Started • 📖 Read the Docs • 💬 Join the Discussion
It helps others discover this tool.
Not affiliated with Anthropic PBC • Independent open-source project