MemPalace (cross-session memory for your sessions)
A cross-session memory system that gives every Claude Code session a set of MCP tools for remembering what you have done before: your transcripts are mined in the background and organised hierarchically into wings and rooms an agent can search. Off by default; turning it on wires the tools into newly spawned sessions.
On this page
What it is
What it is — MemPalace is a cross-session memory system that
MemPalace is a cross-session memory system that gives every Claude Code session a set of MCP tools for remembering things you've done before. Your session transcripts are mined in the background and organized hierarchically into wings (broad areas like a project or topic), rooms (categories like prompts, responses, outcomes), and drawers (individual facts or snippets). Agents can search and add drawers via MCP tools, and you can browse/edit the same content yourself in the MemPalace page. Search is hybrid: semantic (via local 384-dim embeddings) plus full-text — neither needs a network call. Ships as an experimental feature; off by default.
Where to find it
Settings → Features → Enable Memory Palace turns it on. There is no panel of its own — it works by giving your sessions tools, so you see it in what an agent can recall rather than on a screen.
How it behaves
How to use it
- Turn it on. Open Settings → Features → flip on Enable Memory Palace. The default is off. When you enable it, Omniscio writes a small curated
.mcp.jsonto a private per-session path (under Omniscio's data dir, never your project folder) and hands it to each new session's Claude CLI via--mcp-config, so the session can see the MemPalace MCP tools. - Let sessions run normally. While sessions work, agents can call
mempalace_search,mempalace_add_drawer,mempalace_list_wings,mempalace_list_rooms,mempalace_wake_up(returns an identity + essential-story preface), andmempalace_status(diagnostics). No action from you is required — the agent decides when to recall or store. - Browse what's been remembered. Once enabled, a Memory Palace entry (brain icon) appears in the top toolbar's "⋯" (more) menu, under Notes & capture — click it (or pin it to the toolbar) to open the three-pane UI: wings on the left, rooms in the middle-left, drawers in the middle-right. Arrow keys navigate, clicking a drawer reveals the content on the right. (It is NOT a left-sidebar hub. Agents and scripts can also open it over the CLI control server with
POST /ui/openand body{"target":"mempalace"}.) - Search directly. The search bar at the top of the MemPalace page supports hybrid, semantic-only, or lexical-only modes. Use hybrid for best recall; semantic-only if you want concept matches; lexical-only if you need an exact phrase.
- Mining runs after sessions end. You don't trigger it manually. The scheduler debounces per-session mining so a session that just stopped will be extracted into drawers shortly after, not during active work.
- Turning it off. Flip the Enable Memory Palace toggle back off. New sessions will no longer load the MemPalace tools. Any session that was already launched (with its
.mcp.jsonalready on disk) is also covered: the MemPalace MCP server itself re-checks Omniscio's saved toggle every time it boots and exits cleanly when the feature is off, so a stale curated.mcp.jsoncannot resurrect the feature against your wish. As a tidy-up, the next spawn rewrites (or removes) that private per-session file.
Related
Related — use-skills.md
- use-skills.md — Skills are a different way to teach agents: prompt-level recipes, not memory
- session-stuck-in-needs-you.md
Last verified 2026-09-29