xiaoxue_admin
/
mempalace
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mempalace/.codex-plugin
History
Igor Lins e Silva fa9b7e0525 chore(release): 3.3.5 
Bumps version 3.3.4 → 3.3.5 across pyproject.toml, version.py, plugin
manifests, README badge, and uv.lock. Flips CHANGELOG.md from
``[3.3.5] — unreleased`` to ``[3.3.5] — 2026-05-09`` and adds entries
for the four PRs that landed after the bug-fix block was authored:

- Bug Fixes: #1396 (tool_search retry on transient HNSW flush)
- Documentation: #1385 (CONTRIBUTING git-identity guidance, closes #1317)
- Internal: #1431 (test multiprocessing fork → spawn)
- Internal: #1430 (test sqlite connection lifecycle via contextlib.closing)

The four open issues remaining on the v3.3.5 milestone (#1266, #1253,
#1092, #1082) have been moved to v3.4 — they form the concurrent-writer
/ HNSW corruption cluster that needs deeper work than this cycle could
absorb.
 		2026-05-09 21:11:13 -03:00
..
hooks fix: use mempalace CLI in hook scripts instead of python3 -m 2026-04-21 01:26:35 -03:00
skills feat: add Codex plugin support with hooks, commands, and documentation 2026-04-08 19:10:44 +03:00
README.md fix: address Copilot review on PATH visibility (PR #1414) 2026-05-08 02:01:36 -03:00
hooks.json fix(hooks): quote CLAUDE_PLUGIN_ROOT / CODEX_PLUGIN_ROOT in hooks.json (#1076) (#1077) 2026-05-02 21:25:11 -03:00
plugin.json chore(release): 3.3.5 2026-05-09 21:11:13 -03:00

README.md

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
  • uv tool install mempalace (recommended) or 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 so the mempalace-mcp script lands on your PATH (the bundled plugin.json invokes 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.

  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