Igor Lins e Silva
05ad2dc194
version-guard workflow checks five sources must agree: mempalace/version.py, pyproject.toml, .claude-plugin/marketplace.json, .claude-plugin/plugin.json, .codex-plugin/plugin.json. Initial release commit missed the three plugin manifests.
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