explaingit

oleksiijko/pmb

Analysis updated 2026-05-18

61PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A local memory store that lets AI coding assistants like Claude Code, Cursor, and Codex remember facts across sessions.

Mindmap

mindmap
  root((PMB))
    What it does
      Persistent AI agent memory
      Local disk storage
      Cross tool sharing
    Tech stack
      Python
      SQLite
      LanceDB
      MCP protocol
    Use cases
      Remember project decisions
      Share memory across tools
      Skip repeating context
    Audience
      AI coding tool users
      Claude Code and Cursor users
    Status
      Apache 2.0 licensed
      No API key needed
      PyPI installable

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

What do people build with it?

USE CASE 1

Give an AI coding assistant persistent memory of project decisions across separate sessions.

USE CASE 2

Share the same stored facts between multiple AI tools, like Claude Code and Cursor, at once.

USE CASE 3

Store and recall project context without pasting the same background every time you open the agent.

What is it built with?

PythonSQLiteLanceDBMCP

How does it compare?

oleksiijko/pmbalbertaworlds/japanese-corpus-syntactic-analysis-agentblue-pen5805/comfyui-krea2-negpip
Stars616161
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/54/52/5
Audiencedeveloperresearchergeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.11+, runs entirely locally with no API key or cloud service.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notices.

In plain English

PMB (Personal Memory Brain) gives AI coding assistants like Claude Code, Cursor, and Codex a persistent memory that survives between sessions. Normally these tools forget everything when you close them, so you end up pasting the same project context every day. PMB stores facts, decisions, and preferences on your local disk and makes them available to the AI the next time you open it. It works through MCP, a standard protocol that lets AI tools load external tools and data sources. After installing PMB with pip, you run one command to connect it to your agent: for example, "pmb connect claude" writes the necessary config entry so Claude Code can reach the memory server. You can point multiple tools at the same workspace so Claude Code and Cursor both see the same stored facts. Memory is triggered by explicit phrasing. When you tell the AI to "remember" something, or describe a project decision, PMB stores it. When you ask about past research or a past decision, it retrieves it. General factual questions (like "what is JWT?") bypass the memory layer entirely. You can browse what is stored through a terminal interface or a local web dashboard. The storage uses SQLite and LanceDB on your machine, with no cloud service and no API key required. The cost per retrieval is zero. The project reports 94.5% recall accuracy on a standard benchmark (LoCoMo), with a median response time of 70 milliseconds. It supports retrieval across 50 or more languages, including cross-lingual queries where you ask in one language and the stored fact is in another. The project is Apache 2.0 licensed and installable from PyPI as the "pmb-ai" package. It supports nine different AI tools including Cursor, Codex, Windsurf, Gemini CLI, VS Code Copilot, Zed, and Continue. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through installing PMB and connecting it to Claude Code with pmb connect claude.
Prompt 2
Show me how to point both Cursor and Codex at the same PMB workspace so they share memory.
Prompt 3
Explain what triggers PMB to store or recall a memory versus when it does nothing.
Prompt 4
How do I browse what PMB has stored using its terminal interface or web dashboard?

Frequently asked questions

What is pmb?

A local memory store that lets AI coding assistants like Claude Code, Cursor, and Codex remember facts across sessions.

What language is pmb written in?

Mainly Python. The stack also includes Python, SQLite, LanceDB.

What license does pmb use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notices.

How hard is pmb to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pmb for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.