Files
mempalace/.codex-plugin
bensig 102372b179 release: v3.3.3
Restore-integrity release. Unbreaks fresh `pip install mempalace` from
v3.3.2 by re-tagging current develop, which carries both the plugin.json
consumer (shipped in 3.3.2) and the matching mempalace-mcp entry point
in pyproject.toml (added on develop ~10h after the 3.3.2 tag via #340
by @messelink). #1093 diagnosed by @jphein.

Bumps (all 5 sources agree per Version Guard / CLAUDE.md):
- mempalace/version.py              3.3.2 → 3.3.3
- pyproject.toml                     3.3.2 → 3.3.3
- .claude-plugin/plugin.json         3.3.2 → 3.3.3
- .claude-plugin/marketplace.json    3.3.2 → 3.3.3
- .codex-plugin/plugin.json          3.3.2 → 3.3.3
- CHANGELOG.md                        new [3.3.3] entry

No code changes. The fix for #1093 is already on develop via merged PRs
#340, #1021, #851, #942, #833, #673, #661, #659, #1097, #1051, #1001,
#945.

Branch name intentionally outside the `release/*` ruleset so follow-up
CI-fix commits aren't gated behind a nested PR. (Supersedes #1143 —
closed for exactly that reason after it missed 3 of 5 version files.)

Smoke-tested locally from a fresh develop clone:
  grep mempalace-mcp pyproject.toml .claude-plugin/plugin.json   # both ✓
  python -m build --wheel                                        # ✓
  pip install …-py3-none-any.whl                                 # ✓
  which mempalace-mcp                                            # ✓
  mempalace-mcp --help                                           # ✓
2026-04-23 16:44:22 -07:00
..
2026-04-23 16:44:22 -07:00

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

  1. Copy or symlink the .codex-plugin directory into your project root:
cp -r .codex-plugin /path/to/your/project/.codex-plugin
  1. Verify the plugin is detected:
codex --plugins
  1. Initialize your palace:
codex /init

Git Install

  1. Clone the MemPalace repository:
git clone https://github.com/MemPalace/mempalace.git
cd mempalace
  1. Install the Python package:
pip install -e .
  1. The .codex-plugin directory is already in the repo root. Codex CLI will detect it automatically when you run Codex from inside the repository.

  2. 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