# MemPalace

Mines projects and chats into a searchable memory palace for recalling past work.

- Repository: https://github.com/MemPalace/mempalace (60225 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MemPalace/mempalace --skill mempalace -g -a claude-code -y`
Codex: `npx skills add MemPalace/mempalace --skill mempalace -g -a codex -y`
Cursor: `npx skills add MemPalace/mempalace --skill mempalace -g -a cursor -y`
Gemini CLI: `npx skills add MemPalace/mempalace --skill mempalace -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add MemPalace/mempalace`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MemPalace

A searchable memory palace for AI, mine projects and conversations, then search them semantically. Verbatim storage, local-first, zero external API by default.

## Prerequisites

Ensure `mempalace` is installed:

```bash
mempalace --version
```

If not installed (uv recommended):

```bash
uv tool install mempalace   # or: pip install mempalace
```

## Dynamic, version-correct instructions

MemPalace exposes operation-specific instructions through the CLI so this skill stays accurate as MemPalace evolves. To get instructions for any operation:

```bash
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.

## Common operations

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 do

```bash
mempalace instructions help
```

Use when the user is new, unsure what's possible, or asks "what can you do".

### `init`, first-run setup of the palace

```bash
mempalace 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 directory

```bash
mempalace 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 query

```bash
mempalace 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 now

```bash
mempalace instructions status
```

The rest: https://github.com/MemPalace/mempalace/blob/HEAD/.antigravity-plugin/skills/mempalace/SKILL.md