Skip to content

PCIRCLE-AI/claude-code-buddy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,010 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

🧠 MeMesh Plugin

A productivity plugin for Claude Code

Memory, smart task analysis, and workflow automation — all in one plugin.

npm version License MCP

InstallUsageTroubleshooting

繁體中文简体中文日本語한국어FrançaisDeutschEspañolTiếng ViệtภาษาไทยBahasa Indonesia


Why This Project Exists

I love Claude Code. It's changed how I build software.

This project started because I wanted to help more people — especially those new to coding — get the most out of Claude Code for vibe coding. One thing I noticed: when projects grow, it gets hard to keep track of all the decisions you've made across sessions. So I built a plugin (with Claude Code, of course) that remembers for you.

Note: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.

What Does It Do?

MeMesh Plugin makes Claude Code smarter and more productive. It's not just memory — it's a full toolkit:

Searchable Project Memory — Automatically saves decisions, patterns, and lessons as you work. Search by meaning, not just keywords. Ask "what did we decide about auth?" and get an instant answer.

Smart Task Analysis — When you say buddy-do "add user auth", MeMesh analyzes the task, pulls in relevant context from past work, and gives you an enriched plan before executing.

Workflow Automation — Behind the scenes, MeMesh hooks into Claude Code to:

  • Show you a recap of your last session when you start
  • Track which files you've changed and tested
  • Remind you about code reviews before committing
  • Route tasks to the right model (fast model for search, powerful model for planning)

Learn from Mistakes — Record errors and their fixes so they don't happen again. MeMesh builds a knowledge base of what works and what doesn't.

How is this different from Claude's built-in memory?

Claude Code already has auto memory and CLAUDE.md — great for general preferences and instructions. MeMesh adds dedicated project-level tools on top: searchable memory you can query by meaning, task analysis that pulls in past context, and automated workflows that make every session more productive.

Think of it this way:

  • CLAUDE.md = your instruction manual for Claude
  • MeMesh = a searchable notebook + smart assistant that learns as your project grows

Install

You need: Claude Code and Node.js 20+

npm install -g @pcircle/memesh

Restart Claude Code. Done.

Check it works — type this in Claude Code:

buddy-help

You should see a list of commands.

Install from source (for contributors)
git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
cd claude-code-buddy
npm install && npm run build

Usage

MeMesh adds 3 commands to Claude Code:

Command What it does
buddy-do "task" Run a task with memory context
buddy-remember "topic" Search for past decisions and context
buddy-help Show available commands

Examples:

buddy-do "explain this codebase"
buddy-do "add user authentication"
buddy-remember "API design decisions"
buddy-remember "why we chose PostgreSQL"

Everything is stored locally on your machine. Decisions are kept for 90 days, session notes for 30 days.


Where It Runs

Platform Status
macOS ✅ Works
Linux ✅ Works
Windows ✅ Works (WSL2 recommended)

Works with:

  • Claude Code CLI (terminal)
  • Claude Code VS Code Extension
  • Cursor (via MCP)
  • Other MCP-compatible editors

Claude Desktop (Cowork): Basic commands work, but memory features need the CLI version. See Cowork details.


Troubleshooting

MeMesh not showing up?

# Check it's installed
npm list -g @pcircle/memesh

# Check Node.js version (needs 20+)
node --version

# Re-run setup
memesh setup

Then restart Claude Code completely.

More help: Troubleshooting Guide


Learn More


License

MIT — See LICENSE


Something not working? Open an issue — we respond fast.

Report BugRequest Feature