Igor Lins e Silva
5b9d7a9adf
The three plugin directories advertised 36 MCP tools. The server has registered 44 since the logstream and mesh tools landed, which is what README.md and website/reference/mcp-tools.md already say, so the marketplace listings were understating the package to the people deciding whether to install it. No test pins the number in these descriptions; the manifest tests only assert that a description is present and substantive.
MemPalace - Codex CLI Plugin
Give your AI a persistent memory -- mine projects and conversations into a searchable palace backed by ChromaDB, with 44 MCP tools, auto-save hooks, and guided skills.
Prerequisites
- Python 3.9+
- Codex CLI installed and configured
uv tool install mempalace(recommended) orpip 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 so the
mempalace-mcpscript lands on your PATH (the bundledplugin.jsoninvokes it by bare name):
uv tool install --editable . # or: pip install -e .
Plain uv sync is not enough here — it installs the scripts into
.venv/bin/, which Codex will not find unless you activate the venv
before launching Codex.
-
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