Claude forgets everything between sessions. MeMesh fixes that.
Every new Claude Code session starts from zero:
You: "Remember our auth setup from yesterday?"
Claude: "I don't have context from previous sessions..."
You end up re-explaining the same decisions, architecture, and constraints — over and over.
MeMesh gives Claude a persistent memory that survives across sessions:
# Monday: You make a decision
buddy-remember "auth"
# → JWT auth: access tokens 15min, refresh tokens 7 days
# → Decided on Jan 15, stored permanentlyYour project decisions, architecture context, and debugging history — all remembered automatically.
Prerequisites: Claude Code CLI and Node.js >= 20
npm install -g @pcircle/memeshRestart Claude Code. That's it.
Verify it works — in a new Claude Code session, type:
buddy-help
If you see a list of available commands, MeMesh is running.
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| Platform | Status | Notes |
|---|---|---|
| macOS | ✅ Fully tested | Primary development platform |
| Linux | ✅ Fully tested | All distributions supported |
| Windows | ✅ Compatible | WSL2 recommended for best experience |
- Claude Code: Latest version recommended (install guide)
- Node.js: >= 20.0.0 (download)
- npm: >= 9.0.0 (included with Node.js)
MeMesh works seamlessly with:
- ✅ Claude Code CLI (terminal) - Full functionality
- ✅ Claude Code VS Code Extension - Full functionality
- ✅ Cursor (via MCP) - Full functionality
⚠️ Claude Desktop (Cowork) - Partial support (see below)- ✅ Other MCP-compatible editors
Current Status: Cloud-only mode with limited functionality
| Feature | Status | Notes |
|---|---|---|
| MCP Server | ✅ Works | Starts successfully in cloud-only mode |
| Basic Commands | ✅ Works | buddy-help, list-skills, etc. |
| Memory Tools | ❌ Disabled | recall-memory, create-entities, buddy-do, buddy-remember |
| Cloud Sync | ✅ Works | When MEMESH_API_KEY is configured |
| Local Knowledge Graph | ❌ Unavailable | better-sqlite3 cannot compile in Cowork sandbox |
Why Limited: Cowork sandbox has read-only filesystem and blocks native module compilation (better-sqlite3, onnxruntime-node, sqlite-vec).
Future: Full support planned through cloud-first memory architecture. See docs/COWORK_SUPPORT.md for details.
Recommendation: Use CLI version for full functionality until cloud-first memory is implemented.
- Windows native terminal may have display issues (use WSL2)
- Minimum 4GB RAM recommended for large knowledge graphs
- Vector search requires ~100MB disk space for embedding models
MeMesh provides 3 core commands inside Claude Code:
| Command | What it does |
|---|---|
buddy-do "task" |
Execute a task and save what was learned |
buddy-remember "topic" |
Recall past decisions and context |
buddy-help |
Show all available commands |
Examples:
buddy-do "explain this codebase"
buddy-do "add user authentication"
buddy-remember "API design decisions"
buddy-remember "why we chose PostgreSQL"Memories are stored locally on your machine and persist across sessions (90 days for decisions, 30 days for session context).
MeMesh not loading?
# Check installation
npm list -g @pcircle/memesh
# Check Node.js version (needs >= 20)
node --version
# Repair installation
memesh setupThen restart Claude Code completely.
See the full Troubleshooting Guide for more.
- Getting Started — First-time setup walkthrough
- User Guide — Complete usage guide with real-world examples
- Development Guide — Contributor guide for local development
- API Reference — Auto-generated API documentation
- Commands Reference — All commands and tools
- Architecture — How MeMesh works internally
Contributions welcome! See CONTRIBUTING.md.
AGPL-3.0 — See LICENSE
Something not working? Open an issue — we respond fast.