xiaoxue_admin
/
mempalace
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mempalace/.codex-plugin
History
Igor Lins e Silva 280e532724 chore(release): 3.3.6 
Bumps version 3.3.5 → 3.3.6 across pyproject.toml, version.py, plugin
manifests (.claude-plugin/plugin.json, .claude-plugin/marketplace.json,
.codex-plugin/plugin.json), README badge, and uv.lock. Flips CHANGELOG.md
from ``[Unreleased]`` to ``[3.3.6] — 2026-05-24`` and backfills the
major user-facing entries that landed without changelog entries during
the cycle:

Features:
- #1555 office-document mining via --mode extract + virtual line numbers
- #1584 surgical closet pointers with date+line locators (Tier 6a)
- #1558 + #1560 within-wing hallways (entity co-occurrence graph)
- #1565 cross-wing tunnels auto-promoted from hallways
- #1578 Hebbian potentiation + Ebbinghaus decay on hallways/tunnels
- #1236 API-tool transcripts auto-route to wing_api
- #711 hooks.auto_save toggle for silent-mode sessions
- #1605 COCA content-word filter for entity detection
- #1557 case-insensitive entity matching at mine time
- #1483 multilingual embeddings (embeddinggemma-300m) by default

Bug Fixes (selected, user-visible):
- #1540 silent data loss in three unchunked upsert sites
- #1538 paragraph chunker oversized chunks
- #1554 per-file chunk cap too low for transcripts
- #1562 Windows hook subprocess/ChromaDB deadlock
- #1529 create_tunnel corrupted hyphenated wing names
- #1424 save-hook truncated hyphenated project folders
- #1383 KG cache duplicated graphs for symlinked/cased paths
- #1466 silent symlink skip now logged
- #1441 macOS stock-bash 3.2 hook compatibility
- #1500 / #1513 structured JSON-RPC errors on bad MCP input
- #1523 VACUUM + FTS5 rebuild after repair
- #1548 FTS5 validation at end of mine
- plus #1216, #1408, #1438, #1439, #1445, #1452, #1459, #1461, #1466,
  #1470, #1477, #1485, #1500, #1513, #1528, #1532, #1543, #1546, #1585

Performance:
- #1474 convo miner pre-fetches mined-set
- #1487 rebuild_index progress callback
- #1530 MCP cold-start diagnostics + opt-in warmup

Lint passes (ruff 0.15.14); mempalace-mcp entry point alignment
verified per RELEASING.md.
 		2026-05-24 14:17:41 -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.6 2026-05-24 14:17:41 -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