xiaoxue_admin
/
mempalace
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mempalace/.claude-plugin
History
Igor Lins e Silva e1fc71a9b9 chore(release): 3.7.0 
Bump package, plugins, lock, and README badge to 3.7.0. Promote the
post-3.6.0 integrity spine into CHANGELOG: single-writer ownership,
HNSW write defaults and preflight, safer repair/re-mine, MCP/daemon
lifecycle hardening, entity ReDoS guard, and hook write-routing.

Also ruff-format two test files that drifted during conflict merges.

Local validation: ruff check/format clean; 3497 passed, 31 skipped.
 		2026-08-02 05:34:29 -03:00
..
commands fix: update command descriptions to specify 'generic mempalace skill' 2026-04-08 19:15:25 +03:00
hooks fix(claude-plugin): resolve SessionEnd merge semantics 2026-06-19 13:44:52 +00:00
skills fix: point diverged-index recovery at from-sqlite, not re-mine (#1843) 2026-06-22 10:50:16 +10:00
.mcp.json fix: add mempalace-mcp console entry point for pipx/uv compatibility 2026-04-21 01:26:00 -03:00
README.md chore(release): 3.6.0 2026-07-14 20:44:15 -03:00
marketplace.json chore(release): 3.7.0 2026-08-02 05:34:29 -03:00
plugin.json chore(release): 3.7.0 2026-08-02 05:34:29 -03:00

README.md

MemPalace Claude Code Plugin

A Claude Code plugin that gives your AI a persistent memory system. Mine projects and conversations into a searchable palace backed by ChromaDB, with 36 MCP tools, auto-save hooks, and 5 guided skills.

Prerequisites

  • Python 3.9+

Installation

Claude Code Marketplace

claude plugin marketplace add MemPalace/mempalace
claude plugin install --scope user mempalace

Local Clone

claude plugin add /path/to/mempalace

Post-Install Setup

After installing the plugin, run the init command to complete setup (installs the mempalace package via uv tool or pip, configures MCP, etc.):

/mempalace:init

Available Slash Commands

Command Description
/mempalace:help Show available tools, skills, and architecture
/mempalace:init Set up MemPalace -- install, configure MCP, onboard
/mempalace:search Search your memories across the palace
/mempalace:mine Mine projects and conversations into the palace
/mempalace:status Show palace overview -- wings, rooms, drawer counts

Hooks

MemPalace registers three hooks that run automatically:

  • Stop -- Saves conversation context every 15 messages.
  • SessionEnd -- Runs one final save in the background on a clean exit, so short sessions that never hit the Stop interval or a compaction are still captured.
  • PreCompact -- Preserves important memories before context compaction.

Set the MEMPAL_DIR environment variable to a directory path to automatically run mempalace mine on that directory during each save trigger.

MCP Server

The plugin automatically configures a local MCP server with 36 tools for storing, searching, and managing memories. No manual MCP setup is required -- /mempalace:init handles everything.

Full Documentation

See the main README for complete documentation, architecture details, and advanced usage.