Give your AI a persistent memory -- mine projects and conversations into a searchable palace backed by ChromaDB, with 35 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

Copy or symlink the .codex-plugin directory 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 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.

The .codex-plugin directory 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