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--whenso 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_DIRAbsolute path to a directory mempalace mines.required
• PEEPSHOW_MEMPALACE_WINGWing name — becomes a subdirectory and --wing flag when auto-mining.
• PEEPSHOW_MEMPALACE_ROOMRoom 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_BINOverride the `mempalace` executable path. Default `mempalace`.

Write your own

A sink is any executable that reads the--emit jsonpayload on stdin. Shell, Node, Python, Go — the spec's indocs/PLUGINS.md. Register persistent ones withpeepshow sinks add-cmd 'your-command'.