Igor Lins e Silva
c35686c9e1
End-user installs now lead with `uv tool install mempalace`, with `pip install mempalace` kept as a fallback. Dev/contributor docs lead with `uv sync --extra dev` and `uv run` for tests/benchmarks/lint, with the equivalent pip recipe kept inline. The shipped `/mempalace:init` skill instructions (mempalace/instructions/init.md) try `uv tool install` first when uv is on PATH, then fall back through the pip variants. Adds a .python-version pin at 3.12 because the lockfile's onnxruntime==1.24.3 only ships wheels for Python >=3.11; without the pin, `uv sync` on a host where uv prefers 3.10 fails with no source distribution available, which would make the documented command a footgun. pyproject's `requires-python = ">=3.9"` is unchanged — pip users on 3.9/3.10 are unaffected. Files updated: README.md, CONTRIBUTING.md, CLAUDE.md, the gemini-cli guide and example, the .claude-plugin / .codex-plugin READMEs, the mempalace SKILL, the openclaw SKILL, tools/save.md, the three benchmarks docs, and the corresponding website mirrors.
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 19 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 two hooks that run automatically:
- Stop -- Saves conversation context every 15 messages.
- 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 19 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.