Store project files and conversation transcripts as searchable memories while preserving their original text. Retrieve past decisions, code, and notes by meaning, inspect stored content, and review how well memories are organized.
MemPalace — mine projects and conversations into a searchable memory palace. Use when the user asks about MemPalace, memory palace, mining memories, searching memories, palace setup, wings, rooms, or drawers; or when they want to recall past work that may already be filed in their palace.
Review the instructions the agent will receive before you install.
A searchable memory palace for AI — mine projects and conversations, then search them semantically. Verbatim storage, local-first, zero external API by default.
Ensure mempalace is installed:
mempalace --version
If not installed (uv recommended):
uv tool install mempalace # or: pip install mempalace
MemPalace exposes operation-specific instructions through the CLI so this skill stays accurate as MemPalace evolves. To get instructions for any operation:
mempalace instructions <command>
Always prefer the CLI output over what is written here when the two disagree — the CLI is the single source of truth for the installed version.
These are the six operations users ask for most often. Each one wraps a single MemPalace CLI subcommand. The mempalace instructions <name> form returns the full, version-correct guidance.
help — discover what MemPalace can domempalace instructions help
Use when the user is new, unsure what's possible, or asks "what can you do".
init — first-run setup of the palacemempalace instructions init
Use when the user has just installed MemPalace, no palace exists yet, or the user explicitly asks to set up / configure / re-initialize their palace.
mine — ingest a project or conversation directorymempalace instructions mine
Use when the user wants to fold a project's files into their palace, or to ingest exported conversation transcripts into the palace as searchable memory.
search — find verbatim memories by semantic querymempalace instructions search
Use when the user wants to recall something from the past, find a previous decision, or rediscover code/notes/conversations they already wrote.
status — what's in the palace right nowmempalace instructions status
Use when the user asks "what's in my palace", "how big is my palace", or wants a summary of wings, rooms, and drawer counts.
audit — how well organized the palace is, plus a repair sessionmempalace instructions audit
Use when the user asks how well organized or "messy" the palace is, why a scoped search or wake-up misses things, or wants to clean up wings, rooms, tunnels, hallways, or the knowledge graph. Read-only until the user decides each repair.
Inside Antigravity, the MemPalace MCP server registers a rich set of tools. Use these instead of shelling out to the CLI for live operations (search, diary writes, drawer adds, knowledge graph queries, palace status). The MCP tools always reflect the current palace state without spawning a subprocess.
The MCP server is auto-registered when this plugin is installed at ~/.gemini/config/plugins/mempalace/. If the server does not appear in Antigravity's MCP store, run mempalace-mcp --version to verify the binary is on PATH, then restart Antigravity.
If a request would violate any of these principles, refuse and explain — even if it would be technically convenient.
Release checks are opt-in. Ask before enabling weekly checks with
mempalace update configure --enable --installer uv-tool (or pipx / pip,
matching the installation); the default is disabled. Enabling checks
contacts PyPI but sends no palace content, identity, or telemetry. When
mempalace_status reports an available release, distinguish updates.server
from a local proxy's updates.client. Use the local update plan only for the
client scope; a remote server update must be planned and authorized on the hub
host by its operator. Never install an update without explicit user authorization.
When the user asks how well organized the palace is, whether memory is
"messy", why a scoped search or wake-up misses things, or invokes
/mempalace:audit, run the audit and then offer a repair session:
mempalace instructions audit
Follow the returned instructions. In short: run mempalace audit --json
(read-only, safe while the MCP server is running), present the five layer
scores and findings, then walk the user through repairs one structured
question at a time with a recommended option first: merging wings and
rooms spelled two ways, folding stub wings, deleting tunnels on generic
tokens and self-link hallways, agreeing a knowledge-graph predicate
vocabulary, and deciding how to handle generic-room concentration on the
next mine. Moves over deletions, numbers before actions, verbatim content
always. Re-run the audit at the end and write a diary entry with the
before and after scores and every decision made.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Assess how well a MemPalace memory palace is organized, then work through a guided repair session. The skill retrieves audit instructions and proceeds one decision at a time to address its organization.
Find available MemPalace commands, usage tips, and getting started guidance. This skill retrieves the help instructions and follows them step by step to guide users through the basics of using MemPalace.
Initialize a new MemPalace for AI memory through a guided setup process. The skill retrieves setup instructions for a configuration that uses ChromaDB as its data storage backend and follows the returned steps.
Store conversation history and project material locally, then search by meaning and retrieve original text. Organize memories by person or project, track dated relationships and facts, and keep diary entries that connect work across sessions.
Set up and maintain MemPalace as a searchable store of project and conversation memories. Configure a private installation, a shared hub, or a hub client, connect agent tools, and audit how stored information is organized.
Answer questions about past work, people, projects, and decisions by searching stored MemPalace records first. Retrieve exact source wording, check facts at relevant dates, and maintain session continuity without guessing when records are unavailable.