Files
mempalace/website/guide/claude-code.md
T
Igor Lins e Silva 868b4c9b39 fix(hooks): portable mtime in macOS hook throttles; doc cleanup
Address review feedback surfaced on the 3.4.1 release promotion (#1810).

Bug fix — `date -r FILE` is GNU-only. On BSD/macOS `date -r` expects
epoch seconds, not a path, so the staleness/throttle checks in the new
Cursor and Antigravity hooks silently failed on macOS: the state GC
swept on every fire and the pending-save guard was skipped. Replace
with a portable `os.path.getmtime` one-liner via the already-resolved
$MEMPAL_PYTHON_BIN (cursor/lib, antigravity/lib, antigravity save hook).
This restores the "bash 3.2.57 / macOS default" compatibility the
Antigravity changelog claims.

Docs:
- Correct the MCP tool count to 33 (was 19/29/31 in 21 places across
  plugin manifests, READMEs, and website docs — all drifted from the
  TOOLS dict / mcp-tools.md reference, which both have 33).
- Fix broken CHANGELOG link to the Cursor skill (skills/, not
  .cursor-plugin/skills/).
- Fix one-too-many `../` in skills/mempalace/SKILL.md's cursor-hooks
  link (resolved above the repo root).
- Add the required `mcpServers` wrapper to the mcp.json example in
  .cursor-plugin/README.md so copy-paste yields a valid Cursor config.

Left intentionally unchanged: the os.dup2 fd-1 redirect in
mcp_server.py is deliberate (#225 keeps JSON-RPC off fd 1).
2026-06-14 19:54:16 -03:00

1.0 KiB

Claude Code Plugin

The recommended way to use MemPalace with Claude Code — native marketplace install.

Installation

claude plugin marketplace add MemPalace/mempalace
claude plugin install --scope user mempalace

Restart Claude Code, then type /skills to verify "mempalace" appears.

How It Works

With the plugin installed, Claude Code automatically:

  • Starts the MemPalace MCP server on launch
  • Has access to all 33 tools
  • Learns the AAAK dialect and memory protocol from the mempalace_status response
  • Searches the palace before answering questions about past work

No manual configuration needed. Just ask:

"What did we decide about auth last month?"

Alternative: Manual MCP

If you prefer manual setup over the marketplace plugin:

claude mcp add mempalace -- python -m mempalace.mcp_server

Both approaches give identical functionality. The plugin approach handles server lifecycle automatically.

Hooks

Set up auto-save hooks to ensure memories are saved automatically during long conversations.