/palace

name: palace
description: Create and manage memory palaces, the unified storage for knowledge captured from research sessions.

Memory Palace Command

Usage

Create and manage memory palaces for spatial knowledge organization. Palaces are the unified storage for all captured knowledge from research sessions.

List Palaces

/palace list

Shows all existing memory palaces with entry counts and last-modified dates.

View Palace

/palace view <palace-id>

Displays the structure, districts, and entries of a specific palace.

Diagram Palace

/palace diagram <palace-id> [--type map|ascii|entity|heatmap]

Renders the palace as a diagram by invoking `Skill(memory-palace:palace-diagram)`. Types:

• `map` (default): Mermaid flowchart of rooms, entities, and synapses
• `ascii`: box-drawing text overview for inline display
• `entity <entity-id>`: a single entity's connections and triples
• `heatmap`: Mermaid graph with edges styled by synapse strength

Mermaid output renders via the Mermaid Chart MCP; ASCII prints inline.

Create Palace

/palace create <name> <domain> [--metaphor <type>]

Creates a new memory palace with the specified name and domain.

Sync from Queue

/palace sync [--dry-run] [--auto-create]

Process the intake queue (`data/intake_queue.jsonl`) into palaces:

• Matches queued research to existing palaces by domain/tags
• Creates new entries in appropriate palace districts
• With `--auto-create`: Creates new palaces for unmatched domains
• With `--dry-run`: Preview changes without applying

Prune / Maintenance

/palace prune [--stale-days 90]

Check palaces for entries needing cleanup. Also available via the consolidated garden command:

memory_palace_cli.py garden tend --palaces [--stale-days 90]

Identifies:

• Stale entries (older than stale-days, default 90)
• Low quality entries (novelty score < 0.3)
• Duplicate entries across palaces

Shows recommendations and **prompts for user approval** before any changes.

Apply Cleanup

/palace prune --apply

Apply cleanup after reviewing recommendations. **Only run after reviewing the prune check output.**

Status

/palace status

Shows:

• Total palaces and entry counts
• Intake queue size (pending items)
• Palace health metrics

Delete Palace

/palace delete <palace-id>

Removes a palace (creates backup first).

What It Does

1. **Unified Knowledge Storage**: Palaces are the single source of truth for captured knowledge 2. **Queue Processing**: Syncs research from intake queue into palace entries 3. **Domain Organization**: Groups knowledge by domain in districts within palaces 4. **Lifecycle Management**: Tracks creation, updates, quality scores 5. **Integration**: Works with `/update-plugins` for automated maintenance

Architectural Metaphors

Choose a metaphor that fits your knowledge domain:

| Metaphor | Best For | |----------|----------| | `building` | General organization (default) | | `fortress` | Security, defense, production-grade systems | | `library` | Research, documentation | | `workshop` | Practical skills, tools | | `garden` | Evolving knowledge | | `observatory` | Exploration, patterns |

Examples

# List all palaces with entry counts
/palace list

# Check queue size and palace health
/palace status

# Sync queued research into palaces (dry run first)
/palace sync --dry-run
/palace sync

# Create a new palace for a domain
/palace create "K8s Concepts" "kubernetes" --metaphor workshop

# View specific palace structure
/palace view abc123

Data Flow

WebSearch/Research → data/intake_queue.jsonl
                            ↓
                    /palace sync
                            ↓
                    data/palaces/*.json

Research captured during sessions is automatically queued. Run `/palace sync` (or `/update-plugins` which includes it) to process queued items into palaces.

CLI Integration

Uses `memory_palace_cli.py` from the plugin's scripts directory:

# Run from repository root with absolute paths
plugins/memory-palace/.venv/bin/python \
  plugins/memory-palace/scripts/memory_palace_cli.py <command> [args]

# Available commands: enable, disable, status, skills, install,
#                     garden, export, import, create, list, sync, prune, search, manager

**Requirements**:

• Plugin venv must be installed: `cd plugins/memory-palace && uv sync`
• Plugin must be enabled first: `<cli> enable`

**First-Time Setup**:

# 1. Enable the plugin (creates config)
plugins/memory-palace/.venv/bin/python \
  plugins/memory-palace/scripts/memory_palace_cli.py enable

# 2. Now you can list/create palaces
plugins/memory-palace/.venv/bin/python \
  plugins/memory-palace/scripts/memory_palace_cli.py list