xiaoxue_admin
/
mempalace
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mempalace/.codex-plugin
History
Igor Lins e Silva e66cfff0c0 chore(release): 3.4.0 
Minor release. Highlights since v3.3.6:
- feat: pluggable vector backends (qdrant, pgvector, sqlite_exact)
- feat: Docker image for MCP server + CLI
- feat: mempalace migrate-wings (normalize legacy wing names)
- feat: known-systems lexicon for compound product names
- fix: embeddinggemma works with ChromaDB 1.5.x (default-model search)
- fix: drawer_id collision data-loss; WAL import side-effect / kill-switch
- ci: PyPI Trusted Publishing pipeline
 		2026-06-06 03:31:34 -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.4.0 2026-06-06 03:31:34 -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