MemPalace — Mineable markdown notes into a local MemPalace.

What it does

Turn every peepshow run into a MemPalace drawer. Writes a markdown note (YAML frontmatter + metadata + frame refs) into a directory mempalace mines, optionally scoped by wing/room, optionally spawning `mempalace mine` on every run. Zero API keys, 96.6% R@5 retrieval on LongMemEval, fully local.

When to reach for it

• Give a local LLM long-term memory of every video it has watched — no cloud, no API keys
• Semantic search `mempalace search 'the scene where the car crashes'` across every past run
• Scope memory per project via MemPalace wings — frames from `client-a` never bleed into `client-b` queries

Install

npm i -g peepshow
pip install mempalace
mempalace init ~/projects/myapp

Use it

PEEPSHOW_MEMPALACE_DIR=~/projects/myapp \
PEEPSHOW_MEMPALACE_WING=myapp \
peepshow ./demo.mp4 --sink mempalace

Make it automatic

Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.

peepshow sinks add mempalace
peepshow sinks add mempalace --when extension=mp4,mov
peepshow sinks add mempalace --when path=/Volumes/Work/

Configuration

• PEEPSHOW_MEMPALACE_DIR Absolute path to a directory mempalace mines. required
• PEEPSHOW_MEMPALACE_WING Wing name — becomes a subdirectory and --wing flag when auto-mining.
• PEEPSHOW_MEMPALACE_ROOM Room name — nested under the wing.
• PEEPSHOW_MEMPALACE_COPY `0` to skip copying frames (links use absolute paths). Default `1`.
• PEEPSHOW_MEMPALACE_AUTOMINE `1` to spawn `mempalace mine` after writing the note.
• PEEPSHOW_MEMPALACE_BIN Override the `mempalace` executable path. Default `mempalace`.

# Add to ~/.zshrc, ~/.bashrc, or a project .env the agent can load
export PEEPSHOW_MEMPALACE_DIR="..."

peepshow sinks add mempalace
peepshow sinks add mempalace --when extension=mp4,mov

Write your own

A sink is any executable that reads the --emit json payload on stdin. Shell, Node, Python, Go — the spec's in docs/PLUGINS.md. Register persistent ones with peepshow sinks add-cmd 'your-command'.