9f5b8f5fd6
The MCP server config used `python -m mempalace.mcp_server` which fails when mempalace is installed via pipx or uv, since the system python cannot find the module in the isolated venv. Adding a `mempalace-mcp` console_scripts entry point ensures the MCP server works regardless of installation method (pip, pipx, uv, conda). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
MemPalace - Codex CLI Plugin
Give your AI a persistent memory -- mine projects and conversations into a searchable palace backed by ChromaDB, with 19 MCP tools, auto-save hooks, and guided skills.
Prerequisites
- Python 3.9+
- Codex CLI installed and configured
pip install mempalace
Installation
Local Install
- Copy or symlink the
.codex-plugindirectory into your project root:
cp -r .codex-plugin /path/to/your/project/.codex-plugin
- Verify the plugin is detected:
codex --plugins
- Initialize your palace:
codex /init
Git Install
- Clone the MemPalace repository:
git clone https://github.com/MemPalace/mempalace.git
cd mempalace
- Install the Python package:
pip install -e .
-
The
.codex-plugindirectory is already in the repo root. Codex CLI will detect it automatically when you run Codex from inside the repository. -
Initialize your palace:
codex /init
Available Skills
| Skill | Description |
|---|---|
/help |
Show available commands and usage tips |
/init |
Initialize a new memory palace |
/search |
Semantic search across all mined memories |
/mine |
Mine a project or conversation into your palace |
/status |
Show palace status, room counts, and health |
Hooks
The plugin includes auto-save hooks that run on session stop (every 15 messages) and before context compaction, automatically preserving conversation context into your palace.
Set the MEMPAL_DIR environment variable to a directory path to automatically run mempalace mine on that directory during each save trigger.
Support
- Repository: https://github.com/MemPalace/mempalace
- Issues: https://github.com/MemPalace/mempalace/issues