Pim Messelink
be89e49add
Hook scripts used `python3 -m mempalace` which fails when mempalace is installed via pipx or uv. Using the `mempalace` CLI command directly works for all installation methods. Dev users running from source should use `pip install -e .` as documented in CONTRIBUTING.md. 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