Claude Code Buddy (CCB)

Add persistent project memory and smart task routing to Claude Code. Stop repeating context every session - Claude finally remembers your architecture, decisions, and patterns forever. 100% local, 17 MCP tools.

GitHub

MeMesh Plugin

Minimal persistent memory plugin for Claude Code. Remembers decisions, patterns, and context across sessions.

npm version License Node MCP

Installation

npm install -g @pcircle/memesh

What it does

MeMesh gives Claude Code persistent memory through 3 MCP tools, 2 hooks, and a CLI dashboard:

MCP Tools

ToolDescription
rememberStore knowledge — entities with observations, relations, and tags
recallSearch stored knowledge via FTS5 full-text search with optional tag filtering
forgetDelete stored knowledge by name (cascades to observations, relations, tags)

Hooks

HookEventWhat
Session StartSessionStartAuto-recalls project-specific + recent global memories
Post CommitPostToolUse (Bash)Records git commits as knowledge entities

CLI

CommandDescription
memesh-viewGenerate and open an interactive HTML dashboard
memesh-view

MeMesh Dashboard

How it works

  • Storage: SQLite database at ~/.memesh/knowledge-graph.db
  • Search: FTS5 full-text search (no vector embeddings)
  • Isolation: Tag-based project filtering (project:<name>)
  • Schema: entities, observations, relations, tags + FTS5 virtual table
  • Validation: All tool inputs validated with Zod schemas

Architecture

src/
├── cli/
│   └── view.ts           # HTML dashboard generator (D3.js graph + stats)
├── db.ts                 # SQLite database (open/close/migrate, FTS5)
├── knowledge-graph.ts    # Entity CRUD, relations, FTS5 search
├── index.ts              # Package exports
└── mcp/
    ├── server.ts         # MCP server entry point (stdio transport)
    └── tools.ts          # 3 tool handlers + Zod validation

scripts/hooks/
├── session-start.js      # Auto-recall on session start
└── post-commit.js        # Git commit tracking

Dependencies (3): better-sqlite3, @modelcontextprotocol/sdk, zod

Development

npm install
npm run build       # TypeScript compile + chmod executables
npm test            # 73 tests (vitest, BDD style)
npm run typecheck   # tsc --noEmit

License

MIT

Servidores relacionados