# 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"
CCB: ✅ Implemented + Saved to memory

# Session 2 (Tuesday)
You: buddy-remember "auth"
CCB: 📚 "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"
CCB: 🧠 "I see you have JWT. Let's
     integrate OAuth alongside it..."

# In Claude Code/Cursor
buddy-help                          # See all commands
buddy-do "explain how CCB works"    # Watch it intelligently respond
buddy-remember "project decisions"  # Query your project memory

🤔 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

🎯 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?"
CCB: "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"
CCB: *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.

🚀 2-Minute Quick Start

Step 1: Install (Choose Your IDE)

cursor://anysphere.cursor-deeplink/mcp/install?name=@pcircle/claude-code-buddy-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwY2lyY2xlL2NsYXVkZS1jb2RlLWJ1ZGR5LW1jcCJdfQ==

{
  "mcpServers": {
    "@pcircle/claude-code-buddy-mcp": {
      "command": "npx",
      "args": ["-y", "@pcircle/claude-code-buddy-mcp"]
    }
  }
}

Step 2: Test It

# In Claude Code/Cursor, type:
buddy-help

# You should see CCB's command list
# Now try:
buddy-do "explain CCB 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"

CCB 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"

CCB 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"
      │  CCB: ✅ Created + 💾 Remembered
      │
Day 5 │  You: "Add password reset"
      │  CCB: 🧠 "I see you use JWT tokens..."
      │       ✅ Integrated seamlessly
      │
Day 10│  You: "Add OAuth support"
      │  CCB: 🧠 "Based on your JWT + password reset..."
      │       ✅ Consistent with existing auth
      │
Week 8│  You: "Why did we choose JWT again?"
      │  CCB: 📚 *Instant recall from Day 1*

No context re-explanation. Ever again.

📊 Why CCB vs. Others?

🛠️ Advanced Features

cd ~/project-A
buddy-remember "auth"  # Returns project-A's auth decisions

cd ~/project-B
buddy-remember "auth"  # Returns project-B's auth decisions

🧪 Technical Details

🔒 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 CCB 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

🙏 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