Files

T

Igor Lins e Silva c08ec00f4d fix: address Copilot review on PATH visibility (PR #1414 )

- mempalace/instructions/init.md: only skip Step 4 when `mempalace
  --version` succeeds. `pip show` / `uv tool list` reporting an install
  is not enough -- if the package lives in an unactivated venv, Step 5
  (`mempalace init ...`) fails with command-not-found. Treat that case
  as not-installed and re-install via Step 3 into a PATH-visible
  location.
- .codex-plugin/README.md: switch the git-install recipe from `uv sync`
  to `uv tool install --editable .` so the bundled `plugin.json`
  (which invokes `mempalace-mcp` by bare name) can launch the MCP
  server. Plain `uv sync` only puts the script in `.venv/bin/`, which
  Codex won't find unless the venv is activated first.

2026-05-08 02:01:36 -03:00

2.1 KiB

Raw Blame History

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

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

2.1 KiB Raw Blame History