🧠 MeMesh

Note: Formerly known as "Claude Code Buddy (CCB)". Renamed to MeMesh to avoid potential trademark issues.

The Only MCP Server That Remembers

Make Claude Code remember everything. Build faster. Vibe harder.

🚀 Quick Start • 📖 Docs • 🌐 GitHub • 💬 Discussions

---

🎥 See It In Action (Interactive Demo)

🔴 Without MeMesh

# 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* 💢

✅ With MeMesh

# 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..."

---

https://github.com/user-attachments/assets/a389bcd2-1563-4d91-b363-44cdba5f4e44

---

💡 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

---

🤔 The Problem

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.

---

✨ The Solution

❌ Before MeMesh

• Re-explain architecture every session
• Answer same questions repeatedly
• Forget design decisions overnight
• Write similar prompts over and over
• Claude has amnesia 🤕

✅ After MeMesh

• Remembers project architecture
• Recalls past decisions instantly
• Organizes knowledge automatically
• Routes tasks intelligently
• Claude becomes your AI teammate 🤝

---

🎯 Core Features

1. 🧠 Project Memory That Actually Works

# 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.

2. 🎯 Smart Task Routing (Autopilot Mode)

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.

3. 💬 Dead Simple Commands

buddy-do "setup authentication"     # Execute any dev task
buddy-remember "API design"         # Query project memory
buddy-help                          # When stuck

Three commands. Infinite possibilities.

4. 🔐 Secure Credential Storage

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"                      # Cleanup

AES-256-GCM encryption. Local only. Never transmitted.

---

🚀 Installation Options

Choose your preferred installation method:

⚡ npm Global Install (Easiest) ⭐ RECOMMENDED

npm install -g @pcircle/memesh
# Auto-configures everything! Just restart Claude Code.

📦 Quick Install Script (For Local Dev)

git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.sh

🏆 Claude Code Marketplace (Coming Soon)

/plugin install memesh@claude-plugins-official

---

🚀 2-Minute Quick Start

Step 1: Quick Install

Three simple commands:

git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
./scripts/quick-install.sh

The 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.

Note: The installer automatically configures your MCP settings. No manual configuration needed!

Step 2: Test It

# 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

---

💡 Real-World Usage

Scenario 1: Building a New Feature

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"

Scenario 2: "Wait, Why Did We Do That?"

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 vulnerability

Scenario 3: Continuous Development Flow

Day 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.

---

📊 Why MeMesh vs. Others?

Feature	Plain Claude Code	Other MCP Tools	MeMesh
Persistent Memory	❌	⚠️ Basic	✅ Full Knowledge Graph
Smart Routing	❌	❌	✅ Auto-detects task type
Vibe Coding Optimized	⚠️	❌	✅ Built for it
Zero Setup	✅	⚠️ Complex	✅ 2 minutes
Free & Open Source	✅	⚠️ Varies	✅ AGPL-3.0

---

🛠️ Advanced Features

What is it? MeMesh remembers what you did in your last coding session and shows you a summary when you start a new one.

How It Works (Simple Version)

1. When you open Claude Code → MeMesh shows what you did last time
2. While you work → MeMesh quietly tracks your progress
3. When you close Claude Code → MeMesh saves a summary for next time

What You'll See

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.

What Gets Saved

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

Good to Know

• 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

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 decisions

No cross-contamination. Ever.

Context-aware memory retrieval with intelligent ranking:

• 🎯 Semantic search across your knowledge base
• 🏷️ Auto-tagging for better organization
• 📊 Relevance scoring based on context

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

Securely store API keys and credentials:

• 🔐 AES-256-GCM encryption
• 💾 Local SQLite storage (never transmitted)
• 🔑 Use buddy-secret-store and buddy-secret-get

Full integration with Model Context Protocol for seamless Claude Code experience.

Use buddy-help to see all available commands.

---

🧪 Technical Details

Requirements

• Node.js 20+
• Claude Code
• 5 minutes of your time

Platform Support

• ✅ Claude 4.5 (Haiku/Sonnet/Opus)
• ✅ MCP SDK 1.25.3
• ✅ Windows, macOS, Linux

🔒 Security First

• ✅ 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

---

🤝 Contributing

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

---

📚 Documentation

• 📖 Full Documentation
• 🚀 Quick Install Guide
• 📘 User Guide
• 🛠️ API Reference
• ❓ Troubleshooting

---

❓ FAQ

A: Nope. 100% free and open source (AGPL-3.0). Uses your existing Claude Code subscription.

A: Yes. Everything processed locally. Zero external API calls. Zero data upload.

A: MeMesh adds two superpowers:

1. Persistent Memory - Claude remembers your project across sessions
2. Smart Routing - Automatically detects and handles different task types

Think of it as Claude Code + a really good memory + autopilot mode.

A: Absolutely! MeMesh plugin is fully open source.

Want deeper customization? Check our Contributing Guide or fork the repo and make it yours.

A: Yes! Cursor has native MCP support. One-click install.

---

🙏 Acknowledgments

Built on the shoulders of giants:

• Model Context Protocol (MCP) - The foundation
• Claude Code - The platform
• All our amazing contributors and early testers

---

📄 License

AGPL-3.0 - See LICENSE

This means: Use it, modify it, share it. But keep it open source.

---

🌟 Star History

---

Built by developers, for developers

Stop repeating yourself. Start vibing.

🚀 Get Started • 📖 Read the Docs • 💬 Join the Discussion

---

⭐ If MeMesh saved you time today, give it a star!

It helps others discover this tool.

---

Not affiliated with Anthropic PBC • Independent open-source project

Languages: English • 繁體中文