gitwtfhub

wtf is mempalace?

addyosmani/mempalace — explained in plain English

Analysis updated 2026-07-09 · repo last pushed 2026-04-07

48Audience · developerComplexity · 3/5MaintainedSetup · moderate

TL;DR

MemPalace saves and organizes your past AI chat conversations locally so you can search them later. It compresses months of context so any AI model can load it instantly without cloud calls.

Mindmap

mindmap
  root((repo))
    What it does
      Saves AI conversations
      Organizes into memory palace
      Compresses context 30x
      Runs fully offline
    Structure
      Wings for projects
      Rooms for topics
      Closets for summaries
      Tunnels for cross-refs
    Tech stack
      SQLite knowledge graph
      Local storage
      Llama and Mistral support
    Use cases
      Search past decisions
      Import Slack and Claude
      Catch contradictions
    Audience
      Developers
      Team leads
      Multi-project workers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Search past AI conversations to recall why a specific technical decision was made.

REASON 2

Import Slack exports and Claude chats to build a searchable team knowledge base.

REASON 3

Detect contradictions when someone cites outdated facts or wrong task ownership.

REASON 4

Load months of project context into a local AI model without cloud API calls.

What's in the stack?

SQLiteLlamaMistral

How it stacks up

addyosmani/mempalacebennybar/luliredditdantiicu/wine-nx
Stars484848
LanguageDartC
Last pushed2026-04-07
MaintenanceMaintained
Setup difficultymoderatemoderatehard
Complexity3/52/55/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires importing existing conversations and optionally configuring a local AI model like Llama or Mistral for offline use.

Free and open-source software that you can use without cloud dependencies.

Wtf does this do

MemPalace solves a problem anyone who uses AI tools regularly will recognize: every conversation you have with ChatGPT, Claude, or Cursor disappears when the session ends. Six months of decisions, debugging sessions, and architecture debates just vanish. You start over each time. Instead of letting an AI decide what's worth remembering (which usually means it extracts "user prefers Postgres" and throws away the explanation of why), this project stores everything and makes it findable. The system organizes your conversations into a spatial structure inspired by the ancient Greek memory palace technique. Your data gets sorted into wings (people or projects), rooms (specific topics like auth-migration or graphql-switch), and closets (compressed summaries that point to the original files). Cross-references between related topics in different wings are connected automatically through what it calls tunnels. This structure alone improves retrieval by 34% compared to searching through unorganized data. It also uses a custom shorthand language called AAAK that compresses text about 30x with no information loss. It's not meant for humans to read, it's designed so any AI model can load months of context in roughly 120 tokens. This means you can run it with local models like Llama or Mistral and keep your entire memory stack completely offline, with no cloud API calls. The tool is built for developers, team leads, and anyone working across multiple AI-assisted projects. A solo developer could mine six months of conversations across three projects and later search "why did I choose Postgres here?" to get the exact decision and date. A team lead could import Slack exports and Claude conversations, then ask "who decided to use Clerk for auth?" and get the recommendation, the reasoning, and who agreed. It also catches contradictions, if someone says the wrong person handled a task or cites an outdated date, it flags the conflict against stored records. Everything runs locally on your machine using a SQLite-based knowledge graph and local storage. The project is free and open-source, and the benchmarks are reproducible.

Yoink these prompts

Prompt 1
Help me set up MemPalace to import my past ChatGPT and Claude conversations so I can search them by topic later.
Prompt 2
I have Slack exports from my team. How do I load them into MemPalace and ask who decided on our current auth solution?
Prompt 3
Show me how to configure MemPalace with a local Llama or Mistral model so my memory stack stays fully offline.
Prompt 4
Walk me through the AAAK shorthand format in MemPalace and how it compresses months of context into roughly 120 tokens.
Prompt 5
How do I use MemPalace to find why I chose Postgres over another database in a project from six months ago?

Frequently asked questions

wtf is mempalace?

MemPalace saves and organizes your past AI chat conversations locally so you can search them later. It compresses months of context so any AI model can load it instantly without cloud calls.

Is mempalace actively maintained?

Maintained — commit in last 6 months (last push 2026-04-07).

What license does mempalace use?

Free and open-source software that you can use without cloud dependencies.

How hard is mempalace to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mempalace for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.