Igor Lins e Silva
5e9451407f
Version bumps across pyproject.toml, mempalace/version.py, README badge, uv.lock, and plugin manifests (.claude-plugin/*, .codex-plugin/*). CHANGELOG aligned with main (post-3.3.1) and a new [3.3.2] section added covering the 11 PRs merged on develop since v3.3.1 — silent-transcript-drop fix + tandem sweeper (#998), None-metadata guards (#999, #1013), chromadb ≥1.5.4 for Py 3.13/3.14 (#1010), Windows Unicode (#681), HNSW quarantine recovery (#1000), PID stacking guard (#1023), doc-path cleanup (#996, #1012), and RFC 001/002 internal scaffolding (#995, #1014, #990).
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